Timbrar XML firmado
Timbra ante el PAC un CFDI 4.0 que su emisor ya selló con su propio CSD. Recibe el xml completo, con Sello, Certificado y NoCertificado. Cefidia lo envía al PAC tal como llega: no lo revisa, no lo sella ni cambia nada; la respuesta del PAC es la validación. No hace falta un CSD en Cefidia, pero el RFC del emisor (Emisor, Rfc) debe ser de un contribuyente de la cuenta, que es el del documento; el ambiente es el del certificado del XML. La primera llamada no timbra: devuelve un resumen (emisor, receptor, conceptos, total y ambiente), un token de confirmación y su vencimiento. Al llamar de nuevo con el mismo xml y el token se timbra y devuelve el documento con su folio fiscal, el ambiente y los enlaces al XML y al PDF; si el PAC sigue procesando devuelve el estado stamping, y si lo rechaza devuelve solo rejection: el código del SAT, su significado y el campo, sin guardar documento. Con send_to (receiver o hasta 5 direcciones) se envía además un correo con el enlace al documento. Enviar de nuevo el mismo xml (el mismo Sello) devuelve el documento ya existente sin token. Cancelarlo después sí requiere el CSD. Errores: invalid_input con la ruta del problema, taxpayer_not_found, confirmation_invalid, confirmation_expired, pac_unavailable.
Alcance (scope): cefidia:write · Características: Idempotente, Interactúa con el mundo exterior
Parámetros¶
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
xml |
texto | Sí | El CFDI 4.0 completo como XML, ya sellado por su emisor (con Sello). |
send_to |
texto o lista de texto | No | Correo del documento al receptor al timbrarlo: "receiver" usa el correo del receptor guardado en el directorio cuyo RFC es el del Receptor del CFDI; o una lista de hasta 5 direcciones. Va en las dos llamadas. |
confirmation_token |
texto | No | Token de confirmación que devolvió la llamada anterior. |
Esquema de entrada (JSON Schema)¶
{
"additionalProperties": false,
"properties": {
"xml": {
"description": "El CFDI 4.0 completo como XML, ya sellado por su emisor (con Sello).",
"title": "Xml",
"type": "string"
},
"send_to": {
"anyOf": [
{
"const": "receiver",
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Correo del documento al receptor al timbrarlo: \"receiver\" usa el correo del receptor guardado en el directorio cuyo RFC es el del Receptor del CFDI; o una lista de hasta 5 direcciones. Va en las dos llamadas.",
"title": "Send To"
},
"confirmation_token": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Token de confirmación que devolvió la llamada anterior.",
"title": "Confirmation Token"
}
},
"required": [
"xml"
],
"title": "StampSignedXmlInput",
"type": "object"
}