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 22 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",
	"datosFiscales": {
    	"rfc": "",
    	"usoCfdi": "",
    	"regimenFiscal": "",
    	"codigoPostal": ""
  }
}'
Payload
JSON Schema
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "reference": {
      "type": "string"
    },
    "error": {
      "type": "array"
    },
    "status": {
      "type": "string"
    },
    "folio": {
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "pedidoga": {
      "type": "string"
    },
    "datosFiscales": {
      "type": "object",
      "properties": {
        "rfc": {
          "type": "string"
        },
        "usoCfdi": {
          "type": "string"
        },
        "regimenFiscal": {
          "type": "string"
        },
        "codigoPostal": {
          "type": "string"
        }
      },
      "required": [
        "rfc",
        "usoCfdi",
        "regimenFiscal",
        "codigoPostal"
      ]
    }
  },
  "required": [
    "reference",
    "status",
    "folio",
    "type"
  ]
}
Ejemplo de Payload - Status OK
{
	"reference": "0016921514",
	"status": "OK",
	"folio": "524826",
	"type": "S",
	"pedidoga": "23117640210000056300",
	"datosFiscales": {
    	"rfc": "RARA760229C54",
    	"usoCfdi": "G03",
    	"regimenFiscal": "612",
    	"codigoPostal": "21200"
  	}
}
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