Referencia · Retenciones

timbradoTXT-Retenciones

El layout de texto de Retenciones del servicio anterior (COMR, EMIR, NACR, PER, TOT, IRET…).

POST/api/timbradoTXT-Retenciones

El mismo TXT que mandabas por SOAP (TimbradoTXT/Retenciones): renglones COMR, RELRET, EMIR, NACR o EXT, PER, TOT, IRET y los de pagos a extranjeros (P_EXT1 a P_EXT3) y premios. Se sella con el CSD que cargaste para el RFC emisor y se timbra.

Lo que mandas

Campo	Tipo	Para qué
`txtBase64`obligatoriobase64	base64	El archivo TXT en UTF-8.
`obtenerPDF`booleano	booleano	true para recibir también el PDF.

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.
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.
500	200	Un renglón con posiciones de menos o con un dato requerido vacío; el mensaje dice cuál.

Ejemplo

TXT=$(base64 < retencion.txt | tr -d '\n')

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

Forma de la respuesta

{
  "Codigo": "100",
  "Mensaje": "Comprobante timbrado exitosamente.",
  "UUID": "988B5F3A-889E-4C9C-BAC7-0FEE99589858",
  "XMLBase64": "<la Retención timbrada en base64>",
  "PDFBase64": null,
  "IdSeguimiento": "8ce2fefe4ebfae89987a6b49d2f4acbf09542845e2be24e0091cb3aa9ad00d43"
}