API Facturación Electrónica

Autenticación

  1. Registrar empresa.

    El registro de la empresa se hace mediante una solicitud por correo electrónico donde se debe enviar los datos de la empresa, de la resolución y datos del software.

    Una vez se haga el registro de la empresa por parte de e-Misión se le dará un token.

  2. Consumir API.

    Ya habiendo obtenido token la aplicación cliente deberá almacenar el token en una cookie, variable sesión o similar. Y asi cada vez que el usuario interactúe con el API, este token se adjuntará a la solicitud utilizando el encabezado Authorization.

    Authorization: Bearer ``token``

Endpoints

Todas las solicitudes deben ir dirigidas a una URL especifica.

Ambiente

URI BASE

Pruebas

https://test.endpoint.emision.co/api/v1

Producción

https://endpoint.emision.co/api/v1

Para tener en cuenta

Es muy importante que almacene en su base de datos el CUFE o CUDE, la fecha y hora de emisión de los documentos. Ya que estos son necesarios para hacer reenvío de documentos o crear documentos referenciados, como por ejemplo las notas a facturas electrónicas.

Facturación electrónica

Lista de estado de documentos

En la siguiente tabla se describe los diferentes estados por los que puede pasar un documento.

Estado

Nombre

Descripción

5

Aceptada DIAN

Documento validado exitosamente

6

Enviado al Cliente

Documento validado exitosamente y enviado al adquiriente

7

Error

Error en el sistema

8

En verificación

Ejemplar recibido exitosamente pasará a verificación

9

Errores Semánticos XML

El ejemplar contiene errores de validación semántica

10

No hay código de estado DIAN

Respuesta no estandarizada por DIAN

11

Rechazada por la DIAN

La DIAN rechazo el documento

12

Código zipKey inválido

Posiblemente el documento haya sido enviado nuevamente y haya generado un nuevo

13

Rechazada por e-Misión

EL documento no supero las validaciones e-Misión

15

Error 500 DIAN

Error 500 DIAN

Documentos electrónicos equivalentes

Resources de utilidades