API Endpoints

Endpoint para actualizar la información de una empresa

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

Este endpoint permite actualizar la información de la empresa enviada cómo parámetro, ten en cuenta que únicamente se actualizará la información enviada y por lo tanto no es necesario enviar toda la información de la empresa. Si cambias la identification (NIT) de la empresa, su habilitación ante la DIAN (governmentStatus) se reinicia, porque la DIAN habilita al NIT y no a la empresa: deberás realizar de nuevo el proceso de habilitación con el nuevo NIT.

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

Id de la empresa

Body Params

Objeto JSON con la información de la empresa que se desea actualizar

string
length between 5 and 450

Nombre/Razón Social de la empresa

string
length between 1 and 450

Nombre Comercial de la empresa

string
length between 3 and 30

Identificación de la empresa

string
length ≥ 1
^([0-9]{1})$

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

string
enum

Tipo de empresa

Allowed:
boolean

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>

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

Consideraciones

  • El formato debe ser PNG o JPEG. Otros formatos (SVG, WebP, GIF) se rechazan con AEP1011.
  • 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 y del formato se realiza 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 200
^$|^[\s\S]{15,}$

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 4 months 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 4 months ago