Skip to content
FacttecFacttec Developers

Consultas de estado

Consulta el estado de documentos enviados (ZIP, CUFE, trackId, etc.).

5 operaciones documentadas.

Paso 1 — Get Status — zip Factura

Section titled “Paso 1 — Get Status — zip Factura”

POSThttps://api.facttec.co/api/ubl2.1/status/zip/b97308d9-968b-463a-a31a-94159a95e6ed

  • Usa la base URL de Facttec:

    https://api.facttec.co

  • Requiere un token de autorización el cual fue devuelto al realizar el Paso 1 — Configurar empresa, si lo extraviaste, puedes consultarlo o regenerarlo desde el panel admin de Facttec.

  • En URL el último parametro corresponde al zip_key que el response del envio de un documento electrónico en modo asíncrono retorno.

https://api.facttec.co/api/ubl2.1/invoice/status/zip/codigodelzip_key

  • El response de este endpoint muestra si el documento electrónico fue valido o si fue rechazado, en cuyo caso mostrara las reglas de validación por las cuales se rechazo.

Headers

Header Valor
Accept application/json
Content-Type application/json
Authorization Bearer {api_token}
Body JSON 
{
  "sendmail": false,
  "sendmailtome": false,
  "is_payroll": false,
  "is_eqdoc": true
}
Ejemplo cURL
Terminal window
curl -X POST 'https://api.facttec.co/api/ubl2.1/status/zip/b97308d9-968b-463a-a31a-94159a95e6ed' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {api_token}' \
  -H 'Content-Type: application/json' \
  -d '{
  "sendmail": false,
  "sendmailtome": false,
  "is_payroll": false,
  "is_eqdoc": true
}'

Paso 1 — Get Status — zip Nomina

Section titled “Paso 1 — Get Status — zip Nomina”

POSThttps://api.facttec.co/api/ubl2.1/status/zip/7a89a4e4-ecb3-4eca-8ebb-6209c40477ce

  • Usa la base URL de Facttec:

    https://api.facttec.co

  • Requiere un token de autorización el cual fue devuelto al realizar el Paso 1 — Configurar empresa, si lo extraviaste, puedes consultarlo o regenerarlo desde el panel admin de Facttec.

  • En URL el último parametro corresponde al zip_key que el response del envio de un documento electrónico en modo asíncrono retorno.

https://api.facttec.co/api/ubl2.1/invoice/status/zip/codigodelzip_key

  • El response de este endpoint muestra si el documento electrónico fue valido o si fue rechazado, en cuyo caso mostrara las reglas de validación por las cuales se rechazo.

Headers

Header Valor
Accept application/json
Content-Type application/json
Authorization Bearer {api_token}
Body JSON 
{
  "sendmail": true,
  "sendmailtome": true,
  "is_payroll": true
}
Ejemplo cURL
Terminal window
curl -X POST 'https://api.facttec.co/api/ubl2.1/status/zip/7a89a4e4-ecb3-4eca-8ebb-6209c40477ce' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {api_token}' \
  -H 'Content-Type: application/json' \
  -d '{
  "sendmail": true,
  "sendmailtome": true,
  "is_payroll": true
}'

Paso 2 — Get Status — Document Factura

Section titled “Paso 2 — Get Status — Document Factura”

POSThttps://api.facttec.co/api/ubl2.1/status/document/d4905dbc009d247fd3926aae5a7e459e919a72792a231c45d549f0b0e5b07f0e2399c3a49003b556ff8ed9bedc5c72ac

CONSULTA DE ESTADO POR CUFE, CUDE, CUNE

  • Usa la base URL de Facttec:

    https://api.facttec.co

  • Requiere un token de autorización el cual fue devuelto al realizar el Paso 1 — Configurar empresa, si lo extraviaste, puedes consultarlo o regenerarlo desde el panel admin de Facttec.

  • En URL el último parametro corresponde al uuid del documento que se quiere consultar, este uuid puede ser un cufe si es una factura electronica, un cude si es otro documento o un cune si es un documento de nomina.

https://api.facttec.co/api/ubl2.1/invoice/status/document/uuiddeldocumentoaconsultar

  • El response de este endpoint muestra si el documento electrónico fue valido o si fue rechazado, en cuyo caso mostrara las reglas de validación por las cuales se rechazo.

Headers

Header Valor
Accept application/json
Content-Type application/json
Authorization Bearer {api_token}
Body JSON 
{
  "sendmail": true,
  "sendmailtome": true,
  "is_payroll": false,
  "is_eqdoc": false
}
Ejemplo cURL
Terminal window
curl -X POST 'https://api.facttec.co/api/ubl2.1/status/document/d4905dbc009d247fd3926aae5a7e459e919a72792a231c45d549f0b0e5b07f0e2399c3a49003b556ff8ed9bedc5c72ac' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {api_token}' \
  -H 'Content-Type: application/json' \
  -d '{
  "sendmail": true,
  "sendmailtome": true,
  "is_payroll": false,
  "is_eqdoc": false
}'

Paso 2 — Get Status — Document Nomina

Section titled “Paso 2 — Get Status — Document Nomina”

POSThttps://api.facttec.co/api/ubl2.1/status/document/bd07eb71012b593fc2ad42d79cdea403a422204422a3cc8b7822b075d5c44ac388f3159c127b00a2288b97410273a4ff

CONSULTA DE ESTADO POR CUFE, CUDE, CUNE

  • Usa la base URL de Facttec:

    https://api.facttec.co

  • Requiere un token de autorización el cual fue devuelto al realizar el Paso 1 — Configurar empresa, si lo extraviaste, puedes consultarlo o regenerarlo desde el panel admin de Facttec.

  • En URL el último parametro corresponde al uuid del documento que se quiere consultar, este uuid puede ser un cufe si es una factura electronica, un cude si es otro documento o un cune si es un documento de nomina.

https://api.facttec.co/api/ubl2.1/invoice/status/document/uuiddeldocumentoaconsultar

  • El response de este endpoint muestra si el documento electrónico fue valido o si fue rechazado, en cuyo caso mostrara las reglas de validación por las cuales se rechazo.

Headers

Header Valor
Accept application/json
Content-Type application/json
Authorization Bearer {api_token}
Body JSON 
{
  "sendmail": true,
  "sendmailtome": false,
  "is_payroll": true,
  "atacheddocument_name_prefix": "FES-SETP990000263-",
  "html_header": "<h1 style=\"color: #5e9ca0;\">Se&ntilde;or(es), XXXXXXXXXXXXXXXXXXX identificado con NIT 99999999-9</h1><h2 style=\"color: #2e6c80;\">Le informamos que ha recibido un documento electronico de: YYYYYYYYYYYYYYYYYYYYYYYYY</h2>",
  "html_buttons": "<table style=\"border-collapse: collapse; width: 100%;\" border=\"1\"><tbody><tr><td style=\"width: 100%;\"><h2><strong><span style=\"color: #008080;\">Puede descargar su factura mediante el siguiente enlace:</span></strong></h2></td></tr><tr><td style=\"width: 100%;\"><h4><a href=\"https://api.facttec.co/api/download/88261176/FES-FE369.pdf\" target=\"_blank\">Haga click aqui para descargar su factura.</a></h4></td></tr></tbody></table>",
  "html_footer": "<table style=\"border-collapse: collapse; width: 100%;\" border=\"1\"><tbody><tr><td style=\"width: 100%;\"><h2><strong><span style=\"color: #008080;\">Previamente recibio un correo con las credenciales de ingreso a la plataforma.</span></strong></h2></td></tr><tr><td style=\"width: 100%;\"><div><h4><strong>Este es un sistema autom&aacute;tico de aviso, por favor no responda este mensaje de correo.</strong></h4></div></td></tr></tbody></table>"
}
Ejemplo cURL
Terminal window
curl -X POST 'https://api.facttec.co/api/ubl2.1/status/document/bd07eb71012b593fc2ad42d79cdea403a422204422a3cc8b7822b075d5c44ac388f3159c127b00a2288b97410273a4ff' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {api_token}' \
  -H 'Content-Type: application/json' \
  -d '{
  "sendmail": true,
  "sendmailtome": false,
  "is_payroll": true,
  "atacheddocument_name_prefix": "FES-SETP990000263-",
  "html_header": "<h1 style=\"color: #5e9ca0;\">Se&ntilde;or(es), XXXXXXXXXXXXXXXXXXX identificado con NIT 99999999-9</h1><h2 style=\"color: #2e6c80;\">Le informamos que ha recibido un documento electronico de: YYYYYYYYYYYYYYYYYYYYYYYYY</h2>",
  "html_buttons": "<table style=\"border-collapse: collapse; width: 100%;\" border=\"1\"><tbody><tr><td style=\"width: 100%;\"><h2><strong><span style=\"color: #008080;\">Puede descargar su factura mediante el siguiente enlace:</span></strong></h2></td></tr><tr><td style=\"width: 100%;\"><h4><a href=\"https://api.facttec.co/api/download/88261176/FES-FE369.pdf\" target=\"_blank\">Haga click aqui para descargar su factura.</a></h4></td></tr></tbody></table>",
  "html_footer": "<table style=\"border-collapse: collapse; width: 100
…'

Paso 2 — Get Status — Document Events CUFE

Section titled “Paso 2 — Get Status — Document Events CUFE”

POSThttps://api.facttec.co/api/ubl2.1/status/events-document/60f3eee79b3f7d019524f554a40e8c87008cd6686a66816246861609a54bc90e5266af9b989f84168cf68d3a88104e72

CONSULTA DE ESTADO POR CUFE, CUDE, CUNE

  • Usa la base URL de Facttec:

    https://api.facttec.co

  • Requiere un token de autorización el cual fue devuelto al realizar el Paso 1 — Configurar empresa, si lo extraviaste, puedes consultarlo o regenerarlo desde el panel admin de Facttec.

  • En URL el último parametro corresponde al uuid del documento que se quiere consultar, este uuid puede ser un cufe si es una factura electronica, un cude si es otro documento o un cune si es un documento de nomina.

https://api.facttec.co/api/ubl2.1/invoice/status/document/uuiddeldocumentoaconsultar

  • El response de este endpoint muestra si el documento electrónico fue valido o si fue rechazado, en cuyo caso mostrara las reglas de validación por las cuales se rechazo.

Headers

Header Valor
Accept application/json
Content-Type application/json
Authorization Bearer {api_token}
Ejemplo cURL
Terminal window
curl -X POST 'https://api.facttec.co/api/ubl2.1/status/events-document/60f3eee79b3f7d019524f554a40e8c87008cd6686a66816246861609a54bc90e5266af9b989f84168cf68d3a88104e72' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {api_token}'