Documentación – XML

En los siguientes pasos, te guiaremos a través del proceso de integración y uso de nuestra API para el envío de facturas electrónicas a la DIAN en formato XML.

Requisitos:

Registrar Software Propio en la DIAN
Contar con un certificado digital
Contar con una API KEY

API:

url: http://demo.enlote.co

Nota: Para acceder a la API On-Premise, es necesario completar con éxito las pruebas en la nube y demostrar un dominio básico del funcionamiento de la API. De esta manera, garantizamos que la instalación y configuración de la API On-Premise se realice de forma correcta y eficiente.

Creación de empresas

Este servicio web permite la creación de empresas en el sistema, lo cual es un paso previo necesario para la posterior transmisión de documentos electrónicos a la DIAN.

Metodo	URL	Tipo
POST	/api/v1/empresa	Creación
PUT	/api/v1/empresa	Actualización

Headers

Content-Type:application/json

X-API-KEY: API KEY

Cuerpo

Campo JSON	Descripción	Tipo de dato	Notas
tipo_organizacion	Identifica el tipo de organización.	Numérico	1: Persona Jurídica y asimiladas 2: Persona Natural y asimiladas
digito_verificacion	Dígito de verificación del NIT.	Numérico
nombre.nombre_comercial	Nombre comercial de la empresa.	Cadena de texto
nombre.razon_social	Razón social de la empresa.	Cadena de texto
telefono	Número de teléfono de la empresa.	Cadena de texto
direccion	Dirección física de la empresa.	Cadena de texto
municipio	Código DANE del municipio de la empresa.	Numérico
departamento	Código DANE del departamento de la empresa.	Numérico
identificacion	Número de identificación tributaria (NIT) de la empresa.	Numérico
regimen_fiscal	Código del régimen fiscal al que pertenece la empresa.	Numérico	48: Régimen Simplificado
responsabilidades_fiscales	Responsabilidades fiscales de la empresa.	Cadena de texto	R-99-PN: Régimen Simplificado
correo_electronico	Correo electrónico de contacto de la empresa.	Cadena de texto
tipo_identificacion	Código del tipo de identificación de la empresa.	Numérico	31: NIT

Ejemplo

{
    "tipo_organizacion": 1,
    "digito_verificacion": 1,
    "nombre": {
      "nombre_comercial": "Empresa A",
      "razon_social": "Empresa A"
    },
    "telefono": "2424",
    "direccion": "CL 345 3",
    "municipio": "05001",
    "departamento": "05",
    "identificacion": "2222222",
    "regimen_fiscal": 48,
    "responsabilidades_fiscales": "R-99-PN",
    "correo_electronico": "a@municipio.com",
    "tipo_identificacion": "31"
  }

Creación de Certificado

Este servicio web permite registrar los certificados PFX en formato base64 para cada empresa, junto con su clave correspondiente. Los certificados PFX son necesarios para la firma digital de los documentos electrónicos que se envían a la DIAN, asegurando la autenticidad e integridad de la información.

Metodo	URL	Tipo
POST	/api/v1/certificado	Creación
PUT	/api/v1/certificado	Actualización

Headers

Content-Type:application/json

X-API-KEY: API KEY

Cuerpo

Campo JSON	Descripción	Tipo de dato
empresa	Número de identificación tributaria (NIT) de la empresa.	Cadena de texto
clave_certificado	Dígito de verificación del NIT.	Cadena de texto
certificado	Certificado codificado en formato base64.	Cadena de texto

Ejemplo

{
    "empresa": "222222",
    "clave_certificado": "1234",
    "certificado": "MIACAQM..."
    
  }

Transmitir Documento XML

Este servicio web es fundamental para la gestión de facturación electrónica, ya que permite la transmisión de archivos XML, como facturas, notas de crédito y notas de débito, a la DIAN. El servicio se encarga de recibir el archivo XML en formato base64, firmarlo digitalmente con el certificado PFX de la empresa emisora, empaquetarlo en un archivo ZIP y finalmente enviarlo a la DIAN de manera segura.

Metodo	URL	Tipo
POST	/api/v1/documento/transmitir/xml	Creación

Headers

Content-Type:application/json

X-API-KEY: API KEY

Cuerpo

Campo JSON	Descripción	Tipo de dato	Notas
identificacion_software	Identificación del Software Propio	Cadena de texto
pin_software	PIN del Software Propio.	Cadena de texto
ambiente	Tipo de ambiente.	Númerico	1: Producción 2: Pruebas
clave_tecnica	Clave tecnica del rango de numeración asociado.	Cadena de texto
xml	Documento XML codificado en formato base64.	Cadena de texto

Ejemplo

{
    "identificacion_software": "345345-2342-2344-g344-345dsf5as",
    "pin_software": "",
    "ambiente": 2,
    "clave_tecnica": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
    "xml":"PD94bW..."
  }

Consultar Estado Documento XML

Metodo	URL	Tipo
GET	/api/v1/documento/estado	Consulta

Headers

Content-Type:application/json

X-API-KEY: API KEY

Cuerpo

Campo JSON	Descripción	Tipo de dato	Notas
identificacion_software	Identificación del Software Propio	Cadena de texto
empresa	Número de identificación tributaria (NIT) de la empresa.	Cadena de texto
ambiente	Tipo de ambiente.	Númerico	1: Producción 2: Pruebas
identificador	CUFE o CUDE del documento a consultar.	Cadena de texto

Ejemplo

{
    "identificacion_software": "345345-2342-2344-g344-345dsf5as",
    "empresa": "234423423",
    "identificador": "465becc...",
    "ambiente": 2
  }