Saltar a contenido

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"
}