API Alegra Proveedor Electrónico Colombia

Empresas
Sets de pruebas
Nóminas electrónicas
Documentos Equivalentes electrónicos
Facturas de Venta electrónicas
Notas Crédito electrónicas
Notas Débito electrónicas
Documentos Soporte Electrónicos
Eventos electrónicos
Resoluciones
- Endpoint para la consulta de Rangos de Numeración registrados en la DIAN (Resoluciones)get
Dian
Envio Correo Electrónico
- Endpoint para enviar una notificación de un documento electrónico por correopost
Correos Recepción
- Endpoint para la consulta del correo electrónico registrado por el facturador para la recepción de facturas electrónicasget

API Alegra Proveedor Electrónico Colombia

Empresas
Sets de pruebas
Nóminas electrónicas
Documentos Equivalentes electrónicos
Facturas de Venta electrónicas
Notas Crédito electrónicas
Notas Débito electrónicas
Documentos Soporte Electrónicos
Eventos electrónicos
Resoluciones
- Endpoint para la consulta de Rangos de Numeración registrados en la DIAN (Resoluciones)get
Dian
Envio Correo Electrónico
- Endpoint para enviar una notificación de un documento electrónico por correopost
Correos Recepción
- Endpoint para la consulta del correo electrónico registrado por el facturador para la recepción de facturas electrónicasget

Endpoint para emitir una nómina a la DIAN

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

Este endpoint permite emitir una nómina electrónica a la DIAN.

Recuerda visitar previamente las guías de Inicio y la guía de Habilitación en la DIAN - Nómina Electronica

URL Expired

The URL for this request expired after 30 days.

Body Params

Objeto con la información de la nómina electrónica

company

object

Objeto con información de la empresa con la que se desea emitir la nómina electrónica. Este atributo es opcional, sino se envia este objeto, Alegra tomará la compañía asociada al token de autenticación

prefix

string

length ≥ 1

Prefijo de la nómina electrónica

number

double

required

Número de la nómina electrónica

governmentData

object

required

Objeto que contiene la información de la nómina electrónica en formato JSON según el estándar de la DIAN

Responses

Response body

object

emission

object

string

Id de nómina electrónica

idReference

string

Id de nómina electrónica de referencia afectada por la nómina electrónica actual, se utiliza para nóminas de reemplazo y anulación

date

date-time

Fecha de emisión de nómina electrónica

status

string

Estado de la nómina electrónica

REGISTERED WAITING_RESPONSE FAILED SENT CANCELED REPLACED

legalStatus

string

Estado legal de la nómina electrónica ante la DIAN

ACCEPTED ACCEPTED_WITH_OBSERVATIONS REJECTED

companyIdentification

string

Identificación de la empresa empleadora

employeeIdentification

string

Identificación del empleado

cune

string

Código único de nómina electrónica asignado para el documento

prefix

string

length ≥ 1

Prefijo de nómina electrónica

number

double

Número de nómina electrónica

fullNumber

string

Número de nómina electrónica (Incluye prefijo y número)

governmentResponse

object

Objeto con información de la respuesta de la DIAN

xmlFileName

string

Nombre del archivo XML que se envió a la DIAN

zipFileName

string

Nombre del archivo Zip que se envió a la DIAN

Response body

array of objects

object

code

string

Código de error

message

string

required

Mensaje de error

Response body

array of objects

object

code

string

Código de error

message

string

required

Mensaje de error

Response body

array of objects

object

code

string

Código de error

message

string

required

Mensaje de error

Updated 8 months ago

Endpoint para consultar la información de un set de pruebas

Endpoint para consultar nóminas electrónicas

Did this page help you?

Language

Credentials

Bearer

URL


xxxxxxxxxx
14
1
curl --request POST \
2
     --url https://sandbox-api.alegra.com/e-provider/col/v1/payrolls \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "governmentData": {
8
    "Trabajador": {
9
      "AltoRiesgoPension": true,
10
      "SalarioIntegral": true
11
    }
12
  }
13
}
14
'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Updated 8 months ago

Endpoint para consultar la información de un set de pruebas

Endpoint para consultar nóminas electrónicas

Did this page help you?

API Alegra Proveedor Electrónico Colombia
Empresas
Endpoint para actualizar la información de la empresa asociada al tokenpatch
Endpoint para consultar la información de la empresa asociada al tokenget
Endpoint para actualizar la información de una empresapatch
Endpoint para consultar la información de una empresaget
Endpoint para consultar el listado de empresasget
Endpoint para dar de alta a una empresapost
Sets de pruebas
Endpoint para consultar la información de un set de pruebasget
Endpoint para consultar un set de pruebas por governmentIdget
Endpoint para crear un set de pruebaspost
Nóminas electrónicas
Endpoint para obtener un archivo asociado a la nómina electrónicaget
Endpoint para consultar cancelaciones de nóminas electrónicasget
Endpoint para anular una nómina electrónicapost
Endpoint para consultar ajustes de nóminas electrónicasget
Endpoint para reemplazar/ajustar una nómina electrónicapost
Endpoint para consultar una nómina electrónicaget
Endpoint para consultar nóminas electrónicasget
Endpoint para emitir una nómina a la DIANpost
Documentos Equivalentes electrónicos
Endpoint para obtener un archivo asociado a la nota de ajuste al documento equivalente electrónicoget
Endpoint para consultar una nota de ajuste al documento equivalente electrónicoget
Endpoint para emitir una nota de ajuste al documento equivalente electrónico a la DIANpost
Endpoint para obtener un archivo asociado al documento equivalente electrónicoget
Endpoint para consultar un documento equivalente electrónicoget
Emisión Documento Equivalente POS a la DIANpost
Facturas de Venta electrónicas
Endpoint para obtener un archivo asociado a la factura electrónicaget
Endpoint para consultar el historial una factura electrónicaget
Endpoint para consultar una factura electrónicaget
Endpoint para consultar facturas electrónicasget
Endpoint para emitir una factura electrónica a la DIANpost
Notas Crédito electrónicas
Endpoint para obtener un archivo asociado a la nota crédito electrónicaget
Endpoint para consultar una nota crédito electrónicaget
Endpoint para consultar notas crédito electrónicasget
Endpoint para emitir una nota crédito electrónica a la DIANpost
Notas Débito electrónicas
Endpoint para obtener un archivo asociado a la nota débito electrónicaget
Endpoint para consultar una nota débito electrónicaget
Endpoint para consultar notas débito electrónicasget
Endpoint para emitir una nota débito electrónica a la DIANpost
Documentos Soporte Electrónicos
Endpoint para obtener un archivo asociado a la nota de ajuste al documento soporte electrónicoget
Endpoint para consultar una nota de ajuste al documento soporte electrónicoget
Endpoint para emitir una nota de ajuste al documento soporte electrónico a la DIANpost
Endpoint para obtener un archivo asociado al documento soporte electrónicoget
Endpoint para consultar un documento soporte electrónicoget
Endpoint para consultar documentos soporte electrónicosget
Endpoint para emitir un documento soporte electrónico a la DIANpost
Eventos electrónicos
Endpoint para consultar los eventos asociados a una factura hasta la fechaget
Endpoint para obtener un archivo asociado a un evento electrónicoget
Endpoint para consultar la información de un evento por su idget
Endpoint para emitir un evento relacionado a una factura electrónica a partir de su AttachedDocumentpost
Endpoint para emitir un evento relacionado a una factura electrónicapost
Resoluciones
Endpoint para la consulta de Rangos de Numeración registrados en la DIAN (Resoluciones)get
Dian
Endpoint para obtener la tabla de la DIAN con los tipos de concepto de corrección para notas débito disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de concepto de corrección para notas crédito disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de cobertura o plan de beneficios (Sector Salud) disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de modalidades de pago (Sector Salud) disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de usuario (Sector Salud) disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de documento de identificación del usuario (Sector Salud) disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de unidades de cantidad disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de tributos/impuestos disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de régimen/responsabilidades fiscales disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de organización jurídica disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de incapacidad disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de hora extra disponiblesget
Endpoint para obtener la tabla de la DIAN con los subtipos de empleados disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de empleados disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de contratos disponiblesget
Endpoint para obtener la tabla de la DIAN con los periodos de nómina disponiblesget
Endpoint para obtener la tabla de la DIAN con los municipios disponiblesget
Endpoint para obtener la tabla de la DIAN con los departamentos disponiblesget
Endpoint para obtener la tabla de la DIAN con los países disponiblesget
Endpoint para obtener la tabla de la DIAN con los métodos de pago disponiblesget
Endpoint para obtener la tabla de la DIAN con las formas de pago disponiblesget
Endpoint para obtener la tabla de la DIAN con las monedas disponiblesget
Endpoint para obtener la tabla de la DIAN con los lenguajes disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de identificación disponiblesget
Envio Correo Electrónico
Endpoint para enviar una notificación de un documento electrónico por correopost
Correos Recepción
Endpoint para la consulta del correo electrónico registrado por el facturador para la recepción de facturas electrónicasget

API Alegra Proveedor Electrónico Colombia
Empresas
Endpoint para actualizar la información de la empresa asociada al tokenpatch
Endpoint para consultar la información de la empresa asociada al tokenget
Endpoint para actualizar la información de una empresapatch
Endpoint para consultar la información de una empresaget
Endpoint para consultar el listado de empresasget
Endpoint para dar de alta a una empresapost
Sets de pruebas
Endpoint para consultar la información de un set de pruebasget
Endpoint para consultar un set de pruebas por governmentIdget
Endpoint para crear un set de pruebaspost
Nóminas electrónicas
Endpoint para obtener un archivo asociado a la nómina electrónicaget
Endpoint para consultar cancelaciones de nóminas electrónicasget
Endpoint para anular una nómina electrónicapost
Endpoint para consultar ajustes de nóminas electrónicasget
Endpoint para reemplazar/ajustar una nómina electrónicapost
Endpoint para consultar una nómina electrónicaget
Endpoint para consultar nóminas electrónicasget
Endpoint para emitir una nómina a la DIANpost
Documentos Equivalentes electrónicos
Endpoint para obtener un archivo asociado a la nota de ajuste al documento equivalente electrónicoget
Endpoint para consultar una nota de ajuste al documento equivalente electrónicoget
Endpoint para emitir una nota de ajuste al documento equivalente electrónico a la DIANpost
Endpoint para obtener un archivo asociado al documento equivalente electrónicoget
Endpoint para consultar un documento equivalente electrónicoget
Emisión Documento Equivalente POS a la DIANpost
Facturas de Venta electrónicas
Endpoint para obtener un archivo asociado a la factura electrónicaget
Endpoint para consultar el historial una factura electrónicaget
Endpoint para consultar una factura electrónicaget
Endpoint para consultar facturas electrónicasget
Endpoint para emitir una factura electrónica a la DIANpost
Notas Crédito electrónicas
Endpoint para obtener un archivo asociado a la nota crédito electrónicaget
Endpoint para consultar una nota crédito electrónicaget
Endpoint para consultar notas crédito electrónicasget
Endpoint para emitir una nota crédito electrónica a la DIANpost
Notas Débito electrónicas
Endpoint para obtener un archivo asociado a la nota débito electrónicaget
Endpoint para consultar una nota débito electrónicaget
Endpoint para consultar notas débito electrónicasget
Endpoint para emitir una nota débito electrónica a la DIANpost
Documentos Soporte Electrónicos
Endpoint para obtener un archivo asociado a la nota de ajuste al documento soporte electrónicoget
Endpoint para consultar una nota de ajuste al documento soporte electrónicoget
Endpoint para emitir una nota de ajuste al documento soporte electrónico a la DIANpost
Endpoint para obtener un archivo asociado al documento soporte electrónicoget
Endpoint para consultar un documento soporte electrónicoget
Endpoint para consultar documentos soporte electrónicosget
Endpoint para emitir un documento soporte electrónico a la DIANpost
Eventos electrónicos
Endpoint para consultar los eventos asociados a una factura hasta la fechaget
Endpoint para obtener un archivo asociado a un evento electrónicoget
Endpoint para consultar la información de un evento por su idget
Endpoint para emitir un evento relacionado a una factura electrónica a partir de su AttachedDocumentpost
Endpoint para emitir un evento relacionado a una factura electrónicapost
Resoluciones
Endpoint para la consulta de Rangos de Numeración registrados en la DIAN (Resoluciones)get
Dian
Endpoint para obtener la tabla de la DIAN con los tipos de concepto de corrección para notas débito disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de concepto de corrección para notas crédito disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de cobertura o plan de beneficios (Sector Salud) disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de modalidades de pago (Sector Salud) disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de usuario (Sector Salud) disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de documento de identificación del usuario (Sector Salud) disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de unidades de cantidad disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de tributos/impuestos disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de régimen/responsabilidades fiscales disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de organización jurídica disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de incapacidad disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de hora extra disponiblesget
Endpoint para obtener la tabla de la DIAN con los subtipos de empleados disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de empleados disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de contratos disponiblesget
Endpoint para obtener la tabla de la DIAN con los periodos de nómina disponiblesget
Endpoint para obtener la tabla de la DIAN con los municipios disponiblesget
Endpoint para obtener la tabla de la DIAN con los departamentos disponiblesget
Endpoint para obtener la tabla de la DIAN con los países disponiblesget
Endpoint para obtener la tabla de la DIAN con los métodos de pago disponiblesget
Endpoint para obtener la tabla de la DIAN con las formas de pago disponiblesget
Endpoint para obtener la tabla de la DIAN con las monedas disponiblesget
Endpoint para obtener la tabla de la DIAN con los lenguajes disponiblesget
Endpoint para obtener la tabla de la DIAN con los tipos de identificación disponiblesget
Envio Correo Electrónico
Endpoint para enviar una notificación de un documento electrónico por correopost
Correos Recepción
Endpoint para la consulta del correo electrónico registrado por el facturador para la recepción de facturas electrónicasget

200Objeto que representa la respuesta cuando se envía una nómina electrónica a la DIAN

400Objeto que representa una respuesta de error por validaciones

404Objeto que representa una respuesta de error por qué no se ha encontrado el recurso al que se intenta acceder

500Objeto que representa una respuesta de error por qué ha ocurrido un error interno en el sistema