Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 19 Next »

¿Cómo autenticarse para consumir estos servicios?

Autenticación con llave secreta

Actualizar estatus de facturación de un documento

DescripciónEste servicio recibe el estatus de facturación de un documento
MétodoPUT
URL

https://sif-pre.uno-internacional.com/mcs/sif/empresas/{empresaRefId}/documents/billing/status

EJEMPLO ACTIVO

Parametros en URL

empresaRefId: Es el identificador de la sociedad/empresa en BDC

ejemplo: 00000000-0000-1000-0000-000000000001

Ejemplo
Ejemplo cURL
curl --location --request PUT 'https://homol.uno-internacional.com/sif/v3/empresas/00000000-0000-1000-0000-000000000001/documents/billing/status' \
--header 'secret: 646fdfd8b1d93' \
--header 'generatorId: SIF_SAP_PRE' \
--header 'Content-Type: application/json' \
--data '{
"reference": "0016921514",
"error": [],
"status": "OK",
"folio": "524826",
"type": "S",
"pedidoga": "23117640210000056300"
}'
Payload
JSON Schema
{
	"$schema": "http://json-schema.org/draft-04/schema#",
	"type": "object",
	"properties": {
		"reference": {
			"type": "string"
		},
		"error": {
			"type": "object"
		},
		"status": {
			"type": "string"
		},
		"folio": {
			"type": "string"
		},
		"type": {
			"type": "string"
		},
		,
		"pedidoga": {
			"type": "string"
		}
	},
	"required": [
		"reference",
		"status",
		"folio",
		"type"
	]
}
Ejemplo de Payload - Status OK
{
	"reference": "0016921514",
	"status": "OK",
	"folio": "524826",
	"type": "S",
	"pedidoga": "23117640210000056300"
}
Ejemplo Payload - Estatus NOK
{
	"reference": "0016921514",
	"error": [
		"Informar aquí el error que ha impedido generar la factura",
		"si son varios errores",
		"agregar un ítem adicional en este objeto",
		"por cada error",
		"siempre respetando el formato JSON"
	]
	"status": "NOK", 
	"folio": "524826", 
	"type": "F",
	"pedidoga": "23117640210000056300"
}
Respuestas
Código - 204 No content
Respuesta correcta, no se devuelve nada más, solo el código 204
Código - 401 Unauthorized
{
	"error": {
		"code": 401,
		"message": "Token de autorización inválido."
	}
}
Código - 404 Not found
{
	"error": {
		"code": 404,
		"message": "No se encontro el documento"
	}
}
Código - 409 Conflict
{
	"error": {
		"code": 409,
		"message": "El documento ya cuenta con un estatus de facturación correcta"
	}
}
  • No labels