ALalegra
Empresas

Endpoint para actualizar la información de la empresa asociada al token

Changed on

Este endpoint permite actualizar la información de la empresa asociada al token, 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.

patch/company

Request

  • Base URL
    https://sandbox-api.alegra.com/e-provider/col/v1
  • URL
    https://sandbox-api.alegra.com/e-provider/col/v1/company
  • Auth
    HTTP bearer

Request body

namestring

Nombre/Razón Social de la empresa

tradeNamestring

Nombre Comercial de la empresa

identificationstring

Identificación de la empresa

dvstring

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

type'main' | 'associated'

Tipo de empresa

useAlegraCertificateboolean

Indica si se desea usar el certificado de Alegra o no

organizationTypenumber

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

identificationTypestring

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

regimeCodestring

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;

economicActivitiesstring[]

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

emailstring

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

phonestring

Número de teléfono, celular u otro

logostring

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.
otherResponsabilitiesstring

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

Example request

{
  "otherResponsabilities": "RÉGIMEN COMÚN/AGENTE RETENEDOR DE RENTA/AUTORRETENEDORES\nRES. NO. 001240 DEL 20-02-2014.\nGRANDES CONTRIBUYENTES PARA EL DISTRITO DE BOGOTÁ RES. NO. DDI-042065 DE 2017/ACTIVIDAD ECONÓMICA 1512"
}

Response

(unresolved $ref)

Changes

  • 2bc52ab55c2bRevision changes
    • warning

      the /// request property's maxLength was set to 2048

    • warning

      the /// request property's maxLength was set to 2048

    • warning

      the /// request property's maxLength was set to 2048

    • warning

      the /// request property's maxLength was set to 2048

    • warning

      the /// request property's maxLength was set to 2048

    • warning

      the /// request property's maxLength was set to 2048

    • warning

      the /// request property's maxLength was set to 2048

    • warning

      changed the pattern of the request property from ^$|.{15,}$ to ^$|^[\s\S]{15,}$

    • info

      added the new optional request property //

    • info

      the request property's maxLength was increased from 193 to 200