Preparar documento
Guarda un CFDI 4.0 completo como documento preparado, sin timbrarlo. Recibe el CFDI como cfdi (JSON que replica el XML uno a uno, con los complementos y las addendas) o como xml sin sellar, uno solo de los dos, y, con document, el documento preparado (id o folio fiscal) cuyo CFDI reemplaza, que conserva su id y sube su versión; sin document cada llamada crea un documento. El CFDI va completo: Cefidia solo agrega al timbrar el número de certificado, el certificado, el sello y, si falta, la fecha, y no calcula ni revisa nada más; la respuesta del PAC al timbrar es la validación. Solo revisa que se lea como CFDI 4.0 y que su emisor (Emisor, Rfc) sea un contribuyente de la cuenta, que es el del documento. Un CFDI sin Receptor solo se timbra por un enlace de request_receiver_data. Devuelve document (id), version, environment (test o production, null si el contribuyente no tiene CSD; se decide de nuevo al timbrar) y summary: emisor, receptor, tipo, moneda, subtotal, impuestos, total, conceptos y documentos relacionados, como el CFDI los dice. Un documento timbrado, o con un enlace de factura abierto, no se reemplaza. Errores: invalid_input con la ruta del problema, unsupported_version, taxpayer_required, taxpayer_not_found, setup_required, not_found, invalid_state, forbidden.
Alcance (scope): cefidia:write · Características: Destructiva
Parámetros¶
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
cfdi |
objeto | No | El CFDI 4.0 completo como JSON que replica su XML: la raíz Comprobante, un texto es un atributo, un objeto un nodo hijo, una lista de objetos un nodo repetido y #text el texto de un nodo. Un nodo de complemento o de addenda lleva el prefijo de su espacio de nombres en la clave, como cartaporte31:CartaPorte. |
xml |
texto | No | El CFDI 4.0 completo como XML, sin sellar. Se envía cfdi o xml. |
document |
texto | No | Documento preparado (id o folio fiscal) cuyo CFDI reemplaza este; sin él se prepara un documento nuevo. |
Esquema de entrada (JSON Schema)¶
{
"additionalProperties": false,
"properties": {
"cfdi": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "El CFDI 4.0 completo como JSON que replica su XML: la raíz Comprobante, un texto es un atributo, un objeto un nodo hijo, una lista de objetos un nodo repetido y #text el texto de un nodo. Un nodo de complemento o de addenda lleva el prefijo de su espacio de nombres en la clave, como cartaporte31:CartaPorte.",
"title": "Cfdi"
},
"xml": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "El CFDI 4.0 completo como XML, sin sellar. Se envía cfdi o xml.",
"title": "Xml"
},
"document": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Documento preparado (id o folio fiscal) cuyo CFDI reemplaza este; sin él se prepara un documento nuevo.",
"title": "Document"
}
},
"title": "PrepareDocumentInput",
"type": "object"
}