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 14 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
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"
}'
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"
		}
	},
	"required": [
		"reference",
		"status",
		"folio",
		"type"
	]
}
Ejemplo de Payload - Status OK
{
	"reference": "0016921514",
	"status": "OK",
	"folio": "524826",
	"type": "S"
}
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": "S"
}
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