Referencia · Timbrar

selladoTimbCFDI

Sella y timbra un CFDI 4.0 que ya armaste.

POST/api/selladoTimbCFDI

Para cuando tu sistema ya arma el XML. Lo mandas sin sello; el servicio pone NoCertificado, Certificado y Sello con tu CSD y lo timbra.

Lo que mandas

Campo	Tipo	Para qué
`xmlBase64`obligatoriobase64	base64	El XML del CFDI 4.0 en base64, sin sello.
`obtenerPDF`booleano	booleano	Regresa también el PDF en PDFBase64.

Lo que regresa

Campo	Tipo	Para qué
`Codigo`texto	texto	«100» timbrado, «506» ya estaba timbrado; cualquier otro, el rechazo.
`Mensaje`texto	texto	Qué pasó, en español. En un rechazo, la regla del SAT que no se cumplió.
`UUID`texto	texto	El folio fiscal. Sólo con 100 o 506.
`XMLBase64`base64	base64	El CFDI timbrado, completo. Sólo con 100 o 506.
`PDFBase64`base64	base64	El PDF, si lo pediste con obtenerPDF; si no, null.
`IdSeguimiento`texto	texto	La huella del comprobante: con ella preguntas después por su desenlace (seguimientoCFDI).

Códigos

Código	HTTP	Qué significa
100	200	Timbrado.
506	200	Ya estaba timbrado: el mismo UUID y el mismo XML. Trátalo como éxito.
301	200	El comprobante no se pudo armar; el mensaje dice qué campo.
307	200	El XML ya trae un timbre fiscal.
CFDI40xxx…	200	Una regla del SAT no se cumple (la matriz de validaciones); el mensaje dice cuál.
500	200	No hay CSD cargado para el RFC del emisor, o no abre.
500	503	No se sabe si se timbró, o no se pudo enviar. Reintenta con el mismo comprobante.
102	401	Usuario o contraseña inválidos.
105	200	No tienes timbres disponibles (sólo en producción). Compra en tu portal y manda el mismo comprobante: no se gastó nada.

Ejemplo

XML=$(base64 < factura.xml | tr -d '\n')

curl https://pruebas.timbrado.idea15.com/api/selladoTimbCFDI \
  -u "$DUBSARIA_USUARIO:$DUBSARIA_CLAVE" \
  -H "Content-Type: application/json" \
  -d @- <<FIN
{
  "xmlBase64": "$XML",
  "obtenerPDF": false
}
FIN

Respuesta real en pruebas · HTTP 200

{
  "Codigo": "100",
  "Mensaje": "Comprobante timbrado exitosamente",
  "UUID": "BD96D7AB-C6DD-442D-A1DA-FA12D107771B",
  "XMLBase64": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4NCjxj…",
  "PDFBase64": null,
  "IdSeguimiento": "3a05d5e9e99dcdb8796d2792732b5fc3f8640d7cea6311d5f0b8e34cee77ae61"
}

Para tener en cuenta

Sin DOCTYPE ni entidades, y sin el carácter «|» en los datos (salvo CadPago).