Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

Status
subtletrue
colourBlue
titleEjemplo
 
Status
subtletrue
colourGreen
titleACTIVO

Parametros en URL

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

ejemplo: 00000000-0000-1000-0000-000000000001

Ejemplo


Code Block
languagephp
titleEjemplo 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


Code Block
languagephp
titleJSON Schema
{
	  "$schema": "http://json-schema.org/draft-0407/schema#",
  	"type": "object",
  	"properties": {
    		"reference": {
			
      "type": "string"
 		   },
    		"error": {
			      "type": "objectarray"
    		},
  		  "status": {
			      "type": "string"
  		  },
    		"folio""folio": {
      "type": "string"
    },
    "type": {
			
      "type": "string"
    },
    "pedidoga": {
      "type": "string"
 		   },
		"type": {
			
    "datosFiscales": {
      "type": "object",
      "properties": {
        "rfc": {
          "type": "string"
        },
        "usoCfdi": {
          "type": "string"
		},
		,
		"pedidoga": {
			
        },
        "regimenFiscal": {
          "type": "string"
        },
        "codigoPostal": {
          "type": "string"
        }
      },
      "required": [
        "rfc",
        "usoCfdi",
        "regimenFiscal"
		}
	},
	,
        "codigoPostal"
      ]
    }
  },
  "required": [
    		"reference",
  		  "status",
    		"folio",
 		   "type"
	  ]
}


Code Block
languagephp
titleEjemplo de Payload - Status OK
{
	"reference": "0016921514",
	"status": "OK",
	"folio": "524826",
	"type": "S",
	"pedidoga": "23117640210000056300",
	"datosFiscales": {
    	"rfc": "RARA760229C54",
    	"usoCfdi": "G03",
    	"regimenFiscal": "612",
    	"codigoPostal": "21200"
  	}
}


Code Block
titleEjemplo 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


Code Block
languagephp
titleCódigo - 204 No content
Respuesta correcta, no se devuelve nada más, solo el código 204


Code Block
languagephp
titleCódigo - 401 Unauthorized
{
	"error": {
		"code": 401,
		"message": "Token de autorización inválido."
	}
}


Code Block
languagephp
titleCódigo - 404 Not found
{
	"error": {
		"code": 404,
		"message": "No se encontro el documento"
	}
}


Code Block
titleCódigo - 409 Conflict
{
	"error": {
		"code": 409,
		"message": "El documento ya cuenta con un estatus de facturación correcta"
	}
}


...