Timbrar
Timbra un documento preparado ante el PAC. 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 token, Cefidia escribe en el XML el número de certificado, el certificado, el sello y, si el CFDI no la trae, la fecha; lo 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 el documento preparado con su rejection: el código del SAT, su significado y el campo. Con send_to (receiver o hasta 5 direcciones) se envía además un correo con el enlace al documento; el resumen muestra a quién, y receiver sin correo guardado para el RFC del Receptor es invalid_input en send_to. Un documento ya timbrado o en proceso responde su estado sin token. Errores: not_found, receiver_awaited si el CFDI no tiene Receptor, csd_missing, csd_expired, invalid_state, invalid_input, confirmation_invalid, confirmation_expired, pac_unavailable, forbidden.
Alcance (scope): cefidia:write · Características: Destructiva, Idempotente, Interactúa con el mundo exterior
Parámetros¶
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
taxpayer |
texto | No | Nombre o RFC del contribuyente. Se puede omitir si solo hay uno. |
document |
texto | Sí | Id del documento o su folio fiscal (UUID del SAT). |
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": {
"taxpayer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Nombre o RFC del contribuyente. Se puede omitir si solo hay uno.",
"title": "Taxpayer"
},
"document": {
"description": "Id del documento o su folio fiscal (UUID del SAT).",
"title": "Document",
"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": [
"document"
],
"title": "StampDocumentInput",
"type": "object"
}