API Endpoints
Contáctanos

Endpoint para dar de alta a una empresa

post
https://sandbox-api.alegra.com/e-provider/col/v1/companies

Este endpoint permite dar de alta empresas en la API con las configuraciones necesarias para enviar documentos a la DIAN

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Objeto JSON con la información de la empresa

string
required
length between 5 and 450

Nombre/Razón Social de la empresa

string
length between 1 and 450

Nombre Comercial de la empresa

string
required
length between 3 and 30

Identificación de la empresa

string
required
length ≥ 1

Dígito verificador de la identificación de la empresa

string
enum

Tipo de empresa

Allowed:
boolean
required

Indica si se desea usar el certificado de Alegra o no

certificate
object

Objeto que contiene la información del certificado, obligatorio únicamente si el atributo useAlegraCertificate es false

notificationByEmail
object
webhooks
object

Objeto que contiene la información de los webhooks configurados para la empresa. En caso de querer actualizar un webhook, se debe enviar el objeto completo con los webhooks que se desean mantener y los que se desean eliminar

number

Tipo de organización jurídica de la empresa. Se debe colocar el Código que corresponda de la tabla de tipo de organización jurídica de la DIAN

string
length ≤ 2

Tipo de documento de identificación de la empresa. Se debe colocar el Código que corresponda de la tabla de tipos de identificación de la DIAN

string

Régimen al que pertenece la empresa. Se debe colocar el Código que corresponda de la tabla de tipos de responsabilidad fiscal de la DIAN. Para reportar varias obligaciones / responsabilidades, se deben reportar separando cada uno de los valores de la lista con ';'. Ejemplo O‐13;O‐15;

taxCode
object

Objeto que contiene el grupo de detalles tributarios del Emisor

economicActivities
array of strings
length ≥ 1

Lista de actividades económicas de la empresa. Debe informar el código según lista CIIU

economicActivities
string

Correo electrónico de la empresa registrado en la DIAN para la recepción de documentos

string

Número de teléfono, celular u otro

address
object

Objeto que contiene la información relacionada a la dirección.
Grupo de información oficial DIAN <RegistrationAddress | PhysicalLocation>

string
length ≥ 1

Imagen del logo en base64 a incluir en todos los documentos PDF

Consideraciones

  • El tamaño máximo de la imagen es de 150 KB (aproximadamente 150,000 caracteres en base64).
  • La validación final del tamaño se realizará en el servidor después de decodificar la imagen.
  • Si un documento es creado con un logo, este siempre mostrará ese logo. Si el logo es actualizado posteriormente, los documentos creados anteriormente no serán actualizados para mostrar el nuevo logo. Por lo tanto, se recomienda crear documentos con un logo solo después de haber cargado y establecido el logo final.
string
length between 0 and 193

Texto que permite incluir información adicional sobre las responsabilidades fiscales o de otro tipo que la empresa desee reflejar en los documentos emitidos. Esta información se incluirá tanto en el XML como en el PDF de los documentos generados

Responses

Updated about 1 month ago

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 1 month ago