1. Registro de Empresas y Certificados

En este tutorial, te guiaremos paso a paso en el proceso de registro de tu empresa y realización del set de pruebas en la plataforma de la DIAN. Este proceso te permitirá familiarizarte con la plataforma y asegurarte de que estás listo para emitir facturas electrónicas de manera oficial.

Requisitos

Para comenzar, es imprescindible contar con un certificado digital de facturación electrónica asociado a la empresa con la que realizarás las pruebas. Este certificado se puede obtener a través de una de las siguientes plataformas:

Certificado de pruebas

En caso de que no dispongas de un certificado digital, te ofrecemos la posibilidad de realizar pruebas utilizando nuestro certificado de pruebas. Es importante tener en cuenta que este certificado está destinado exclusivamente para pruebas locales y no está habilitado para la emisión de facturas electrónicas.

Descargar Certificado

Contraseña: 123456

Registrar Software Propio

Para obtener la identificación y el rango de prueba es necesario registrarse como software propio en la plataforma de la DIAN.

Sigue este video para aprender como hacerlo:

Video

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

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