Saltar a contenido

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