Estructura de los documentos
Factura de Venta
A continuación se detallan cada uno de los elementos de una factura electrónica.Detalle de losTags
{
"number": 990000195,
"type_document_id": 1,
"date": "2020-10-06",
"time": "04:08:12",
"resolution_number": "18760000001",
"prefix": "SETP",
"sendmail": true,
"sendmailtome": true,
"disable_confirmation_text": true,
"establishment_name": "NOMBRE DEL ESTABLECIMIENTO O COMERCIAL",
"establishment_address": "CL 41 10 A 35",
"establishment_phone": "3163338144",
"establishment_municipality": 429,
"establishment_email": "correodelestablecimiento@dominio.com",
"establishment_logo": "",
"atacheddocument_name_prefix": "",
"actividadeconomica": "6311",
"notes": "Nota general del documento",
"noteAIU": "Nota solo en Factura AIU",
"seze": "2021-2020",
"head_note": "",
"foot_note": "Documento Generado por el software NextPyme Plus",
"send_customer_credentials": false,
"smtp_parameters": {
"host": "smtp.dominio.com",
"port": "587",
"username": "correoemisor@dominio.com",
"password": "clavesecreta",
"encryption": "tls"
},
"annexes": [
{
"document": "JVBERi0xLjQKJfbk/N8KMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovVmVyc2lvbiA..........",
"extension": "pdf"
}
],
"order_reference": {
"id_order": "A23061977FBC",
"issue_date_order": "2020-10-01"
},
"delivery": {
"languaje_id": 79,
"country_id": 46,
"municipality_id": 822,
"address": "CLL 4 NRO 33-90",
"actual_delivery_date": "2020-07-30"
},
"idcurrency": 135,
"calculationrate": "3546.00",
"calculationratedate": "2021-04-03",
"email_cc_list": [
{
"email": "emailone@gmail.com"
},
{
"email": "emailtwo@hotmail.com"
}
],
"customer": {
"identification_number": 901249232,
"dv": 0,
"name": "NOMBRE EMPRESA",
"phone": "0000000",
"address": "CLL 18A # 11 - 20",
"email": "soporte@dominio.com",
"merchant_registration": "00000000",
"type_document_identification_id": 6,
"type_organization_id": 1,
"municipality_id": 439,
"type_regime_id": 2
},
"payment_form": {
"payment_form_id": 2,
"payment_method_id": 30,
"payment_due_date": "2020-11-06",
"duration_measure": "30"
},
"prepaid_payment": {
"idpayment": "A3123856",
"paidamount": "100000.00",
"receiveddate": "2020-03-01",
"paiddate": "2020-03-05",
"instructionid": "PRUEBA DE PREPAGO RECIBIDO"
}
"allowance_charges": [
{
"discount_id": 1,
"charge_indicator": false,
"allowance_charge_reason": "DESCUENTO GENERAL",
"amount": "0.00",
"base_amount": "1000000.00"
}
],
"legal_monetary_totals": {
"line_extension_amount": "840336.13",
"tax_exclusive_amount": "840336.13",
"tax_inclusive_amount": "1000000.00",
"allowance_total_amount": "0.00",
"charge_total_amount": "0.00",
"payable_amount": "1000000.00"
},,
"with_holding_tax_total": [
{
"tax_id": 5,
"tax_amount": "25210.08",
"percent": "3",
"taxable_amount": "840336.13"
}
],
"tax_totals": [
{
"tax_id": 1,
"tax_amount": "159663.86",
"percent": "19",
"taxable_amount": "840336.13"
}
],
"invoice_lines":
[
{
"unit_measure_id": 70,
"invoiced_quantity": "1",
"line_extension_amount": "1000000.00",
"free_of_charge_indicator": false,
"allowance_charges": [{
"charge_indicator": false,
"allowance_charge_reason": "DESCUENTO GENERAL",
"amount": "0.00",
"base_amount": "1000000.00"
}
],
"description": "COMISION POR SERVICIOS",
"notes": "ESTA ES UNA NOTA DE DETALLE DE LINEA.",
"code": "COMISION",
"type_item_identification_id": 4,
"price_amount": "1000000.00",
"base_quantity": "1"
}
],
"sales_assistant": "PANCRACIO LUCUMI",
"invoice_template": "one",
"template_token": "",
"web_site": "NOMBRE EMPRESA - www.dominio.com"
}
Descripción - Haga click en la propiedad
-
"number" Obligatorio number
Corresponde al número del documento según el consecutivo autorizado por la DIAN
-
"type_document_id" Obligatorio number
Su valor debe ser el ID de la tabla tipo de documento electrónico
-
"date" Obligatorio date
Corresponde a la fecha del documento en formato YYYY-MM-DD y no podrá variar en más de 10 días de la fecha actual
-
"time" Obligatorio timestamp
Corresponde a la hora del documento en formato 24 horas.
-
"resolution_number" y "prefix":" Obligatorio string
Es el número de resolución y prefijo asignado por la DIAN y que previamente han sido configurados en la API
-
"sendmail" Obligatorio booleano
Esta propiedad permite definir si se enviará de forma automatica el correo al cliente
-
"sendmailtome" Opcional booleano
Esta propiedad permite definir si se enviará de forma automatica el documento al correo del emisor, recibe true o false
-
"disable_confirmation_text" Opcional booleano
Activa el texto de confirmación informando al cliente a que correo debe enviar el soporte de pago de la factura, recibe true o false
-
"establishment_name" Opcional string
Permite incluir en el PDF el nombre comercial de la empresa (La representación quedaría con el nombre legal y nombre comercial)
-
"establishment_address" Opcional string
Permite incluir en el PDF la dirección comercial de la empresa.
-
"establishment_phone" Opcional string
Permite incluir en el PDF el teléfono comercial de la empresa.
-
"establishment_municipality" Opcional string
Permite incluir en el PDF el municipio del establemiento comercial de la empresa.
-
"establishment_email" Opcional string
Permite definir un correo diferente en la cabezera del documento.
-
"establishment_logo" Opcional string
Permite establecer un logo diferente en cada documento a emitir, el logo se debe enviar el en formato BASE64.
-
"atacheddocument_name_prefix" Opcional string
Permite definir un prefijo al archivo .ZIP que se enviará al cliente con el PDF y XML al momento de generar la factura.
-
"actividadeconomica" Opcional string
Indique el código de la actividad economica del emisor del documento
-
"notes" Opcional string
Permite ingresar una descripción general del documento en caso que exista.
-
"noteAIU" Opcional string
Permite ingresar una descripción del documento o detalles del contrato, en caso de factura AIU es obligatoria.
-
"seze" Opcional string
Permite informar el peridio de inicia de la empresa, así como el año actual en el PDF.
-
"head_note" Opcional string
Permite incluir una nota en la cabezera del documento.
-
"foot_note" Opcional string
Permite incluir una nota en pie de página del documento.
-
"send_customer_credentials" Opcional string
Permite enviar las credenciales al cliente para que pueda consultar el historial de los documentos recibidos en la plataforma (Cliente receptor)
-
"smtp_parameters" Opcional string
Esta funcionalidad permite enviar cada factura desde un correo personalizado.
Nota: el servidor STMP se puede establecer fijo y de esa forma se envian todos los documento con el mismo email.
host: Servidor STMP del proveedor de correo (smtp.miproveedor.com)
port: Puerto del proveedor de correo generalemente se utilizan (587, 465, 25)
username: correo@midominio.com
password: password del correo del proveedor de correo
encryption: TLS o SSL
-
"annexes" Opcional string | base64
Esta funcionalidad permite enviar archivos adjuntos con el correo de la factura. Acepta multiples formatos de archivos
document: documento a enviar el formato base64
extension: pdf, doc, xls, ppt, png, jpg, gif
-
"order_reference" Opcional string
Permite referenciar la orden de compra o pedido, en el se debe incluir el numero de la orden (id_order) y la fecha de la misma.
-
"delivery" Opcional number | string
Permite inidicar un lugar de entrega del producto, en el se debe incluir el idioma (languaje_id), el pais (country_id), municipio (municipality_id), dirreción(address) y fecha de entrega (actual_delivery_date).
-
"idcurrency", "calculationrate" y "calculationratedate" Opcional number | date
Si su empresa factura en otra moneda diferente al peso, deberá indicar el ID de la moneda, el valor de la TRM (calculationrate) y la fecha de la misma (calculationratedate)
-
"email_cc_list" Opcional email
Permite definir un lista de email a los que será enviado un documento de forma simultanea
-
"customer" Obligatorio number | string
En la propiedad customer se deben enviar los datos del cliente.
identification_number: corresponde al nit o cedula del cliente en caso de ser cedula no se utiliza la propiedad dv
name: en esta propiedad se debe enviar el nombre del cliente
phone: corresponde al teléfono del cliente
address: deberá ir la dirección del cliente
email: debe ir el email al cual será enviada la factura del cliente
merchant_registration: se deberá enviar el número de matricula mercantil o en su defecto "0000000"
type_document_identification_id, type_organization_id, municipality_id y type_regime_id: se de utilizar los IDs correspondientes de cada tabla de acuerdo con la información suministrada.
Si es a consumidor final debe llevar la siguiente estructura
"customer": { "identification_number": 222222222222, "name": "CONSUMIDOR FINAL", "merchant_registration": "0000000-00" } -
"payment_form" Obligatorio number | string
En la propiedad payment_form se debe enviar el metodo y forma de pago
Las propiedades payment_form_id y payment_method_id: hacen referencia al ID de las tablas formas y métodos de pago. En la propiedad payment_due_date deberá informar la fecha de pago y finalmente en la propiedad duration_measure informará la cantidad de días de plazo en caso que sea venta a crédito.
-
"prepaid_payment" Opcional number | string
Se utiliza para informar pagos o abonos que fueron realizados de forma anticipada a la emisión de la factura.
idpayment: es el identificador del pago (Ejemplo: el número de deposito)
paidamount: es el valor pagado
receiveddate: fecha de recibido
paiddate: fecha del pago
instructionid: descripción adicional
-
"allowance_charges" Obligatorio number | string | booleano
En esta propiedad se informan descuentos o cargos a nivel de factura, es decir descuentos o cargos que no afectan las bases gravables. Los descuentos o cargos que afectan bases gravables se informan a nivel de ítem.
ChargeIndicator: Indica que el elemento es un Cargo y no un descuento
Cargo es true, es un débito aumenta el valor de la factura y se debe reportar en el LegalMonetary. Descuento es false, un crédito descuenta el valor de la factura antes de tributos y debe reportarse en el LegalMonetaryallowance_charge_reason: Texto libre para informar de la razón del descuento (Obligatorio de informar si es descuento a nivel de factura.)
amount: Es el valor de descuento
base_amount: Es la base sujeta al descuento
-
"legal_monetary_totals" Obligatorio number | string
Grupo de campos para información relacionadas con los valores totales aplicables a la factura
line_extension_amount: Total valor bruto, suma de los valores brutos de las líneas de la factura.
tax_exclusive_amount: Total Valor Base Imponible, Base imponible para el cálculo de los tributos
tax_inclusive_amount: Total de Valor Bruto más tributos, el Valor Bruto más tributos tiene que ser igual a Valor Brutode la factura que contienen el valor comercial más la suma de los tributos de todas las líneas de detalle.
allowance_total_amount: Descuento Total: Suma de todos los descuentos aplicados a nivel de la factura
charge_total_amount: Cargo Total, Suma de todos los cargos aplicados a nivel de la factura
payable_amount: valor de la factura, valor total de ítems (incluyendo cargos y descuentos a nivel de ítems) + valor tributos + valor cargos – valor descuentos.
-
"with_holding_tax_total" Opcional number | string
Grupo de campos para información relacionadas con los valores de retenciones, estas serán a nivel informativo y no restarán al valor del documento.
tax_id: identificador del tributo (Ver tabla)
tax_amount: Valor del tributo
percent: tarifa del tributo
taxable_amount: base Imponible sobre la que se calcula el valor del tributo
-
"tax_totals" Obligatorio number | string
Grupo de campos para información relacionadas con los tributos (Impuestos)
tax_id: identificador del tributo (Ver tabla)
tax_amount: valor del tributo
percent: tarifa del tributo
taxable_amount: Base Imponible sobre la que se calcula el valor del tributo
-
"invoice_lines" Obligatorio number | float | string | booleano
Grupo de campos para información relacionadas las lineas del documento o items a facturar
unit_measure_id: Corresponde a uno de los valores de la tabla de unidades de medida
invoiced_quantity: Cantidad del producto o servicio
line_extension_amount: Valor total de la línea. Cantidad x Precio Unidad menos descuentos más recargos que apliquen para la línea.
free_of_charge_indicator: Indica que el elemento es un Cargo y no un descuento
allowance_charges: Ver expliación de los descuentos generales tiene el mismo funcionamiento pero a nivel productos o servicios
description: Descripción del producto o servicio
notes: Texto libre para añadir información adicional al artículo.
code: Código asignado al producto por el cliente
type_item_identification_id: ver tabla tipo de productos
price_amount: ver tabla tipo de productos
base_quantity: Es la cantidad por la que se multiplicará el valor para obtener el total de la linea
-
"sales_assistant": Opcional string
En este campo se informa la persona que realizo la venta (vendedor)
-
"web_site": Opcional string
En este campo se informa el sitio web de la empresa
-
"invoice_template": Opcional string
En este campo se informa el nombre del formato del PDF a utilizar en la representación grafica Ejemplo: "one"
-
"template_token": Opcional string
En este campo se informa el TOKEN 2 que brinda acceso a los formatos PDF premiums
-
"Moneda", "Texto Modo de Operación", "Nota Legal": Opcional string
Textos fijos en en este formato de factura
Los siguientes campos estan disponibles solo en la versión del PDF Premium (No incluida en los planes)
Notas
Detalle de losTags
{
"billing_reference": {
"number": "FE10",
"uuid": "5aad9e5a566a5750f61921cb6350db3c135bfecd17fc330d90b8a1d8fd423efb5a76f6b099c55dc5ce6bdd5e1406faa7",
"issue_date": "2022-03-15"
},
"number": 1,
"prefix": "ND",
"type_document_id": 5,
"date": "2022-03-15",
"time": "08:40:15",
"sendmail": true,
"sendmailtome": true,
"disable_confirmation_text": true,
"establishment_logo": "",
"atacheddocument_name_prefix": "",
"actividadeconomica": "6311",
"notes": "Nota general del documento",
"head_note": "",
"foot_note": "Documento Generado por el software NextPyme Plus",
"annexes": [
{
"document": "JVBERi0xLjQKJfbk/N8KMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovVmVyc2lvbiA..........",
"extension": "pdf"
}
],
"delivery": {
"languaje_id": 79,
"country_id": 46,
"municipality_id": 822,
"address": "CLL 4 NRO 33-90",
"actual_delivery_date": "2020-07-30"
},
"idcurrency": 135,
"calculationrate": "3546.00",
"calculationratedate": "2021-04-03",
"notes": "PRUEBA DE NOTA DEBITO",
"customer": {
"identification_number": 901249232,
"dv": 0,
"name": "NOMBRE EMPRESA",
"phone": "0000000",
"address": "CLL 18A # 11 - 20",
"email": "soporte@dominio.com",
"merchant_registration": "00000000",
"type_document_identification_id": 6,
"type_organization_id": 1,
"municipality_id": 439,
"type_regime_id": 2
},
"tax_totals": [
{
"tax_id": 1,
"tax_amount": "0.00",
"taxable_amount": "0.00",
"percent": "0.00"
}
],
"requested_monetary_totals": {
"line_extension_amount": "32000.00",
"tax_exclusive_amount": "0",
"tax_inclusive_amount": "32000.00",
"allowance_total_amount": "0",
"charge_total_amount": "0.00",
"payable_amount": "32000.00"
},
"debit_note_lines": [
{
"unit_measure_id": 70,
"invoiced_quantity": "1",
"line_extension_amount": "32000.00",
"free_of_charge_indicator": false,
"allowance_charges": [
{
"charge_indicator": false,
"allowance_charge_reason": "DESCUENTO GENERAL",
"amount": "0.00",
"base_amount": "32000.00"
}
],
"tax_totals": [
{
"tax_id": 1,
"tax_amount": "0.00",
"taxable_amount": "0.00",
"percent": "0.00"
}
],
"description": "PRUEBA DE NOTA DEBITO ELECTRONICA",
"code": "001NOTA",
"type_item_identification_id": 4,
"price_amount": "32000",
"base_quantity": "1"
}
]
}
Descripción - Haga click en la propiedad
-
"billing_reference" Obligatorio number | string | date
number: número de la factura a la que se aplicará la nota
uuid: CUFE de la factura
issue_date: fecha de la factura
-
"number" Obligatorio number
Corresponde al número del documento que el cliente a decidido utilizar, no hay resolución para este tipo de documento
-
"type_document_id" Obligatorio number
Su valor debe ser el ID de la tabla tipo de documento electrónico.
-
"date" Obligatorio date
Corresponde a la fecha del documento en formato YYYY-MM-DD y no podrá variar en más de 10 días de la fecha actual
-
"time" Obligatorio timestamp
Corresponde a la hora del documento en formato 24 horas
-
"prefix":" Obligatorio string
Es el número de resolución y prefijo asignado por la DIAN y que previamente han sido configurados en la API
-
"sendmail" Obligatorio booleano
Esta propiedad permite definir si se enviará de forma automatica el correo al cliente.
-
"sendmailtome" Opcional booleano
Esta propiedad permite definir si se enviará de forma automatica el documento al correo del emisor, recibe true o false
-
"establishment_logo" Opcional string
Permite establecer un logo diferente en cada documento a emitir, el logo se debe enviar el en formato BASE64.
-
"atacheddocument_name_prefix" Opcional string
Permite definir un prefijo al archivo .ZIP que se enviará al cliente con el PDF y XML al momento de generar la factura.
-
"actividadeconomica" Opcional string
Indique el código de la actividad economica del emisor del documento
-
"notes" Opcional string
Ingrese la nota general del documento en caso que exista.
-
"head_note" Opcional string
Permite incluir una nota en la cabezera del documento.
-
"foot_note" Opcional string
Permite incluir una nota en pie de página del documento.
-
"annexes" Opcional string | base64
Esta funcionalidad permite enviar archivos adjuntos con el correo de la factura. Acepta multiples formatos de archivos
document: documento a enviar el formato base64
extension: pdf, doc, xls, ppt, png, jpg, gif
-
"delivery" Opcional number | string
Permite inidicar un lugar de entrega del producto, en el se debe incluir el idioma (languaje_id), el pais (country_id), municipio (municipality_id), dirreción(address) y fecha de entrega (actual_delivery_date).
-
"idcurrency", "calculationrate" y "calculationratedate" Opcional number | date
Si su empresa factura en el otra moneda diferente al peso, deberá indicar el ID de la moneda, el valor de la TRM (calculationrate) y la fecha de la misma (calculationratedate)
-
"customer" Obligatorio number | string
En la propiedad customer se deben enviar los datos del cliente.
identification_number: corresponde al nit o cedula del cliente en caso de ser cedula no se utiliza la propiedad dv
name: en esta propiedad se debe enviar el nombre del cliente
phone: corresponde al teléfono del cliente
address: deberá ir la dirección del cliente
email: debe ir el email al cual será enviada la factura del cliente
merchant_registration: se deberá enviar el número de matricula mercantil o en su defecto "0000000"
type_document_identification_id, type_organization_id, municipality_id y type_regime_id: se de utilizar los IDs correspondientes de cada tabla de acuerdo con la información suministrada.
Si es a consumidor final debe llevar la siguiente estructura
"customer": { "identification_number": 222222222222, "name": "CONSUMIDOR FINAL", "merchant_registration": "0000000-00" } -
"allowance_charges" Obligatorio number | string | booleano
En esta propiedad se informan Descuentos o cargos a nivel de factura, es decir descuentos o cargos que no afectan las bases gravables. Los descuentos o cargos que afectan bases gravables se informan a nivel de ítem.
ChargeIndicator: Indica que el elemento es un Cargo y no un descuento
Cargo es true, es un Débito aumenta el valor de la factura y se debe reportar en el LegalMonetary. Descuento es false, un Crédito descuenta el valor de la factura antes de tributos y debe reportarse en el LegalMonetaryallowance_charge_reason: Texto libre para informar de la razón del descuento (Obligatorio de informar si es descuento a nivel de factura.)
amount: Es el valor de descuento
base_amount: Es la base sujeta al descuento
-
"requested_monetary_totals" Obligatorio number | string
Grupo de campos para información relacionadas con los valores totales aplicables a la nota
line_extension_amount: Total valor bruto, suma de los valores brutos de las líneas de la nota.
tax_exclusive_amount: Total Valor Base Imponible, Base imponible para el cálculo de los tributos
tax_inclusive_amount: Total de Valor Bruto más tributos: el Valor Bruto más tributos tiene que ser igual a Valor Brutode la factura que contienen el valor comercial más la Sumade los tributos de todas las líneas de detalle.
allowance_total_amount: Descuento Total: Suma de todos los descuentos aplicados a nivel de la nota
charge_total_amount: Cargo Total: Suma de todos los cargos aplicados a nivel de la nota
payable_amount: Valor de la Factura: Valor total de ítems (incluyendo cargos y descuentos a nivel de ítems)+valor tributos + valor cargos – valor descuentos.
-
"with_holding_tax_total" Opcional number | string
Grupo de campos para información relacionadas con los valores de retenciones, estas serán a nivel informativo y no restarán al valor del documento.
tax_id: Identificador del tributo (Ver tabla)
tax_amount: Valor del tributo
percent: Tarifa del tributo .
taxable_amount: Base Imponible sobre la que se calcula el valor del tributo
-
"tax_totals" Obligatorio number | string
Grupo de campos para información relacionadas con los tributos (Impuestos)
tax_id: Identificador del tributo (Ver tabla)
tax_amount: Valor del tributo
percent: Tarifa del tributo .
taxable_amount: Base Imponible sobre la que se calcula el valor del tributo
-
"debit_note_lines" Obligatorio number | float | string | booleano
Grupo de campos para información relacionadas las lineas del documento o items a facturar
unit_measure_id: Corresponde a uno de los valores de la tabla de unidades de medida
invoiced_quantity: Cantidad del producto o servicio
line_extension_amount: Valor total de la línea. Cantidad x Precio Unidad menos descuentos más recargos que apliquen para la línea.
free_of_charge_indicator: Indica que el elemento es un Cargo y no un descuento
allowance_charges: Ver expliación de los descuentos generales tiene el mismo funcionamiento pero a nivel productos o servicios
description: Descripción del producto o servicio
notes: Texto libre para añadir información adicional al artículo.
code: Código asignado al producto por el cliente
type_item_identification_id: ver tabla tipo de productos
price_amount: ver tabla tipo de productos
base_quantity: Es la cantidad por la que se multiplicará el valor para obtener el total de la linea
Detalle de losTags
{
"billing_reference": {
"number": "SETP990000246",
"uuid": "a3e47abf60b5f399647c6ebf534b1abfa17ac989c6c77e0ec09909b8091c647de80bcdf8cb45dcb7e0052695c545d3ee",
"issue_date": "2021-03-02"
},
"discrepancyresponsecode": 2,
"discrepancyresponsedescription": "PRUEBA DE MOTIVO NOTA CREDITO",
"notes": "Nota general del documento!",
"number": 771,
"type_document_id": 4,
"date": "2021-03-03",
"time": "06:00:13",
"establishment_name": "NEXTPYME PLUS",
"establishment_address": "BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2",
"establishment_phone": "3226563672",
"establishment_municipality": 600,
"sendmail": true,
"sendmailtome": true,
"seze": "2021-2017",
"head_note": "Documento Generado por NextPyme Plus - Nota en el encabezado del documento",
"foot_note": "Documento Generado por NextPyme Plus - Nota al final del documento",
"customer": {
"identification_number": 901249232,
"dv": 0,
"name": "NOMBRE EMPRESA",
"phone": 3106031839,
"address": "CLL 18A # 11 - 20",
"email": "EMPRESAlorica@gmail.com",
"merchant_registration": "0000000-00",
"type_document_identification_id": 6,
"type_organization_id": 1,
"type_liability_id": 7,
"municipality_id": 822,
"type_regime_id": 1
},
"tax_totals": [
{
"tax_id": 1,
"tax_amount": "0.00",
"taxable_amount": "0.00",
"percent": "0.00"
}
],
"legal_monetary_totals": {
"line_extension_amount": "45000.00",
"tax_exclusive_amount": "0",
"tax_inclusive_amount": "45000.00",
"allowance_total_amount": "0",
"charge_total_amount": "0.00",
"payable_amount": "45000.00"
},
"credit_note_lines":
[
{
"unit_measure_id": 70,
"invoiced_quantity": "1",
"line_extension_amount": "45000.00",
"free_of_charge_indicator": false,
"allowance_charges": [{
"charge_indicator": false,
"allowance_charge_reason": "DESCUENTO GENERAL",
"amount": "0.00",
"base_amount": "45000.00"
}
],
"tax_totals": [
{
"tax_id": 1,
"tax_amount": "0.00",
"taxable_amount": "0.00",
"percent": "0.00"
}
],
"description": "PRUEBA NOTA CONTABLE ELECTRONICA",
"code": "001NOTA",
"type_item_identification_id": 4,
"price_amount": "45000",
"base_quantity": "1"
}
]
}
-
"billing_reference" Obligatorio number | string | date
number: número de la factura a la que se aplicará la nota
uuid: CUFE de la factura
issue_date: fecha de la factura
-
"number" Obligatorio number
Corresponde al número del documento que el cliente a decidido utilizar, no hay resolución para este tipo de documento
-
"type_document_id" Obligatorio number
Su valor debe ser el ID de la tabla tipo de documento electrónico.
-
"date" Obligatorio date
Corresponde a la fecha del documento en formato YYYY-MM-DD y no podrá variar en más de 10 días de la fecha actual
-
"time" Obligatorio timestamp
Corresponde a la hora del documento en formato 24 horas
-
"prefix":" Obligatorio string
Es el número de resolución y prefijo asignado por la DIAN y que previamente han sido configurados en la API
-
"sendmail" Obligatorio booleano
Esta propiedad permite definir si se enviará de forma automatica el correo al cliente.
-
"sendmailtome" Opcional booleano
Esta propiedad permite definir si se enviará de forma automatica el documento al correo del emisor, recibe true o false
-
"establishment_logo" Opcional string
Permite establecer un logo diferente en cada documento a emitir, el logo se debe enviar el en formato BASE64.
-
"atacheddocument_name_prefix" Opcional string
Permite definir un prefijo al archivo .ZIP que se enviará al cliente con el PDF y XML al momento de generar la factura.
-
"actividadeconomica" Opcional string
Indique el código de la actividad economica del emisor del documento
-
"notes" Opcional string
Ingrese la nota general del documento en caso que exista.
-
"head_note" Opcional string
Permite incluir una nota en la cabezera del documento.
-
"foot_note" Opcional string
Permite incluir una nota en pie de página del documento.
-
"annexes" Opcional string | base64
Esta funcionalidad permite enviar archivos adjuntos con el correo de la factura. Acepta multiples formatos de archivos
document: documento a enviar el formato base64
extension: pdf, doc, xls, ppt, png, jpg, gif
-
"delivery" Opcional number | string
Permite inidicar un lugar de entrega del producto, en el se debe incluir el idioma (languaje_id), el pais (country_id), municipio (municipality_id), dirreción(address) y fecha de entrega (actual_delivery_date).
-
"idcurrency", "calculationrate" y "calculationratedate" Opcional number | date
Si su empresa factura en el otra moneda diferente al peso, deberá indicar el ID de la moneda, el valor de la TRM (calculationrate) y la fecha de la misma (calculationratedate)
-
"customer" Obligatorio number | string
En la propiedad customer se deben enviar los datos del cliente.
identification_number: corresponde al nit o cedula del cliente en caso de ser cedula no se utiliza la propiedad dv
name: en esta propiedad se debe enviar el nombre del cliente
phone: corresponde al teléfono del cliente
address: deberá ir la dirección del cliente
email: debe ir el email al cual será enviada la factura del cliente
merchant_registration: se deberá enviar el número de matricula mercantil o en su defecto "0000000"
type_document_identification_id, type_organization_id, municipality_id y type_regime_id: se de utilizar los IDs correspondientes de cada tabla de acuerdo con la información suministrada.
Si es a consumidor final debe llevar la siguiente estructura
"customer": { "identification_number": 222222222222, "name": "CONSUMIDOR FINAL", "merchant_registration": "0000000-00" } -
"allowance_charges" Obligatorio number | string | booleano
En esta propiedad se informan Descuentos o cargos a nivel de factura, es decir descuentos o cargos que no afectan las bases gravables. Los descuentos o cargos que afectan bases gravables se informan a nivel de ítem.
ChargeIndicator: Indica que el elemento es un Cargo y no un descuento
Cargo es true, es un Débito aumenta el valor de la factura y se debe reportar en el LegalMonetary. Descuento es false, un Crédito descuenta el valor de la factura antes de tributos y debe reportarse en el LegalMonetaryallowance_charge_reason: Texto libre para informar de la razón del descuento (Obligatorio de informar si es descuento a nivel de factura.)
amount: Es el valor de descuento
base_amount: Es la base sujeta al descuento
-
"requested_monetary_totals" Obligatorio number | string
Grupo de campos para información relacionadas con los valores totales aplicables a la nota
line_extension_amount: Total valor bruto, suma de los valores brutos de las líneas de la nota.
tax_exclusive_amount: Total Valor Base Imponible, Base imponible para el cálculo de los tributos
tax_inclusive_amount: Total de Valor Bruto más tributos: el Valor Bruto más tributos tiene que ser igual a Valor Brutode la factura que contienen el valor comercial más la Sumade los tributos de todas las líneas de detalle.
allowance_total_amount: Descuento Total: Suma de todos los descuentos aplicados a nivel de la nota
charge_total_amount: Cargo Total: Suma de todos los cargos aplicados a nivel de la nota
payable_amount: Valor de la Factura: Valor total de ítems (incluyendo cargos y descuentos a nivel de ítems)+valor tributos + valor cargos – valor descuentos.
-
"with_holding_tax_total" Opcional number | string
Grupo de campos para información relacionadas con los valores de retenciones, estas serán a nivel informativo y no restarán al valor del documento.
tax_id: Identificador del tributo (Ver tabla)
tax_amount: Valor del tributo
percent: Tarifa del tributo .
taxable_amount: Base Imponible sobre la que se calcula el valor del tributo
-
"tax_totals" Obligatorio number | string
Grupo de campos para información relacionadas con los tributos (Impuestos)
tax_id: Identificador del tributo (Ver tabla)
tax_amount: Valor del tributo
percent: Tarifa del tributo .
taxable_amount: Base Imponible sobre la que se calcula el valor del tributo
-
"credit_note_lines" Obligatorio number | float | string | booleano
Grupo de campos para información relacionadas las lineas del documento o items a facturar
unit_measure_id: Corresponde a uno de los valores de la tabla de unidades de medida
invoiced_quantity: Cantidad del producto o servicio
line_extension_amount: Valor total de la línea. Cantidad x Precio Unidad menos descuentos más recargos que apliquen para la línea.
free_of_charge_indicator: Indica que el elemento es un Cargo y no un descuento
allowance_charges: Ver expliación de los descuentos generales tiene el mismo funcionamiento pero a nivel productos o servicios
description: Descripción del producto o servicio
notes: Texto libre para añadir información adicional al artículo.
code: Código asignado al producto por el cliente
type_item_identification_id: ver tabla tipo de productos
price_amount: ver tabla tipo de productos
base_quantity: Es la cantidad por la que se multiplicará el valor para obtener el total de la linea
Nómina
Detalle de losTags
{
"type_document_id": 9,
"establishment_name": "EMPRESA S.A.S",
"establishment_address": "CRA 18A 11 - 20",
"establishment_phone": "3017882489",
"establishment_municipality": 439,
"establishment_email": "alternate_email@alternate.com",
"head_note": "TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA,
"foot_note": "TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA,
"novelty": {
"novelty": false,
"uuidnov": ""
},
"period": {
"admision_date": "2018-10-10",
"settlement_start_date": "2021-07-01",
"settlement_end_date": "2021-07-15",
"worked_time": "15.00",
"issue_date": "2021-07-28"
},
"worker_code": "0001",
"prefix": "A",
"consecutive": 1,
"payroll_period_id": 4,
"notes": "PRUEBA DE ENVIO DE NOMINA ELECTRONICA",
"worker": {
"type_worker_id": 1,
"sub_type_worker_id": 1,
"payroll_type_document_identification_id": 3,
"municipality_id": 822,
"type_contract_id": 1,
"high_risk_pension": false,
"identification_number": 41946692,
"surname": "CARDONA",
"second_surname": "VILLADA",
"first_name": "ELIZABETH",
"address": "BRR LIMONAR MZ 6 CS 3 ET 1",
"email": "email_del_empleado@email.com",
"integral_salarary": false,
"salary": "1500000.00"
},
"payment": {
"payment_method_id": 10,
"bank_name": "BANCO DAVIVIENDA",
"account_type": "AHORROS",
"account_number": "126070603280"
},
"payment_dates": [{
"payment_date": "2021-03-10"
},
{
"payment_date": "2021-03-15"
}
],
"accrued": {
"worked_days": 15,
"salary": "750000.00",
"transportation_allowance": "109000.00",
"HEDs": [{
"start_time": "2021-03-01T18:00:00",
"end_time": "2021-03-01T19:00:00",
"quantity": 1,
"percentage": 1,
"payment": "7812.50"
}
],
"HENs": [{
"start_time": "2021-03-01T21:00:00",
"end_time": "2021-03-01T22:00:00",
"quantity": 1,
"percentage": 2,
"payment": "10937.50"
}],
"HRNs": [{
"start_time": "2021-03-01T21:00:00",
"end_time": "2021-03-01T22:00:00",
"quantity": 1,
"percentage": 3,
"payment": "8437.50"
}
],
"HEDDFs": [{
"start_time": "2021-03-01T21:00:00",
"end_time": "2021-03-01T22:00:00",
"quantity": 1,
"percentage": 4,
"payment": "12500.00"
}],
"HRDDFs": [{
"start_time": "2021-03-01T16:00:00",
"end_time": "2021-03-01T17:00:00",
"quantity": 1,
"percentage": 5,
"payment": "10937.50"
}
],
"HENDFs": [{
"start_time": "2021-03-01T21:00:00",
"end_time": "2021-03-01T22:00:00",
"quantity": 1,
"percentage": 6,
"payment": "15625.00"
}],
"HRNDFs": [{
"start_time": "2021-03-01T21:00:00",
"end_time": "2021-03-01T22:00:00",
"quantity": 1,
"percentage": 7,
"payment": "13125.00"
}],
"common_vacation": [{
"start_date": "2021-03-01",
"end_date": "2021-03-10",
"quantity": 10,
"payment": "500000.00"
}],
"paid_vacation": [{
"quantity": 5,
"payment": "250000.00"
}],
"service_bonus": [{
"quantity": 365,
"payment": "1500000.00",
"paymentNS": "250000.00"
}],
"severance": [{
"payment": "1500000.00",
"percentage": "12",
"interest_payment": "180000.00"
}],
"work_disabilities": [{
"start_date": "2021-03-05",
"end_date": "2021-03-10",
"type": 3,
"quantity": 5,
"payment": "250000.00"
}
],
"maternity_leave": [{
"start_date": "2021-03-11",
"end_date": "2021-03-15",
"quantity": 5,
"payment": "250000.00"
}],
"paid_leave": [{
"start_date": "2021-03-11",
"end_date": "2021-03-15",
"quantity": 5,
"payment": "250000.00"
}],
"non_paid_leave": [{
"start_date": "2021-03-11",
"end_date": "2021-03-15",
"quantity": 5
}],
"bonuses": [{
"salary_bonus": "100000.00"
},
{
"salary_bonus": "95000.00",
"non_salary_bonus": "50000.00"
}
],
"aid": [{
"salary_assistance": "95000.00",
"non_salary_assistance": "50000.00"
}],
"legal_strike": [{
"start_date": "2021-03-01",
"end_date": "2021-03-10",
"quantity": 10
}],
"other_concepts": [{
"salary_concept": "35000",
"non_salary_concept": "50000",
"description_concept": "INGRESO POR OTROS CONCEPTOS"
}],
"compensations": [{
"ordinary_compensation": "135000",
"extraordinary_compensation": "250000"
}],
"epctv_bonuses": [{
"paymentS": "135000",
"paymentNS": "250000",
"salary_food_payment": "135000",
"non_salary_food_payment": "250000"
}],
"commissions": [{
"commission": "135000"
},
{
"commission": "155000"
}
],
"third_party_payments": [{
"third_party_payment": "155000"
}],
"advances": [{
"advance": "135000"
},
{
"advance": "50000"
}
],
"endowment": "250000.00",
"sustenance_support": "1350000.00",
"telecommuting": "250000.00",
"withdrawal_bonus": "250000.00",
"compensation": "135000.00",
"accrued_total": "5145562.50"
},
"deductions": {
"eps_type_law_deductions_id": 1,
"eps_deduction": "60000.00",
"pension_type_law_deductions_id": 5,
"pension_deduction": "60000.00",
"fondossp_type_law_deductions_id": 5,
"fondosp_deduction_SP": "60000.00",
"fondossp_sub_type_law_deductions_id": 5,
"fondosp_deduction_sub": "60000.00",
"labor_union": [{
"percentage": "2.00",
"deduction": "30000.00"
}],
"sanctions": [{
"public_sanction": "300000.00",
"private_sanction": "130000.00"
}],
"orders": [{
"description": "LIBRANZA POR PEDIDO NRO 34256 GRUPO EXITO",
"deduction": "13000.00"
}],
"third_party_payments": [{
"third_party_payment": "155000"
},
{
"third_party_payment": "59000"
}
],
"advances": [{
"advance": "255000"
},
{
"advance": "79000"
}
],
"other_deductions": [{
"other_deduction": "133000"
}],
"voluntary_pension": "158000.00",
"withholding_at_source": "65000.00",
"afc": "33500.00",
"cooperative": "25000.00",
"tax_liens": "38500.00",
"supplementary_plan": "65000.00",
"education": "59000.00",
"refund": "47000.00",
"debt": "39000",
"deductions_total": "120000.00"
}
}
Descripción - Haga click en la propiedad
-
"type_document_id" Obligatorio
number
Su valor debe ser el ID de la tabla tipo de documento electrónico.
-
"establishment_name" Opcional
string
Permite incluir en el PDF el nombre comercial de la empresa (La representación quedaría con el nombre legal y nombre comercial)
-
"establishment_address" Opcional
string
Permite incluir en el PDF la dirección comercial de la empresa.
-
"establishment_phone" Opcional
string
Permite incluir en el PDF el teléfono comercial de la empresa.
-
"establishment_municipality"
Opcional
string
Permite incluir en el PDF el municipio del establemiento comercial de la empresa.
-
"establishment_email" Opcional
string
Permite definir un correo diferente en la cabezera del documento.
-
"period" Obligatorio string |
date
En la propiedad Periodo se deben enviar los datos de la liquidación.
admision_date: corresponde a la fecha de ingreso del empleado.
settlement_start_date: en esta propiedad se debe enviar la fecha inicial del periodo a informar.
settlement_end_date: corresponde a la fecha del final de periodo liquidado a informar.
worked_time: Corresponde a la cantidad de días laborados.
issue_date: Esta propiedad es la fecha en la que se reporta la liquidación.
-
"worker_code" Obligatorio string
Es el código interno asignado al empleado en su software.
-
"prefix" y "consecutive" Obligatorio string
Corresponde al prefijo asociado al servicio de nómina electrónica y el consecutivo de los documentos. ejemplo: NI1
-
"payroll_period_id" Obligatorio string
Corresponde al ID de la tabla periodos de pagos.
-
"worker" Obligatorio string | number | booleano
type_worker_id: Corresponde al ID de la tabla tipo de empleado
sub_type_worker_id: Corresponde al ID de la tabla sub-tipo de empleado
payroll_type_document_identification_id: Corresponde al ID de la tabla tipo de identification. (Cedula, Nit)
payroll_type_document_identification_id: Corresponde al ID de la tabla tipo de identification.
municipality_id: Corresponde al ID de la tabla municipios.
type_contract_id: Corresponde al ID de la tabla tipos de contratos.
high_risk_pension: Indique si es pensión de alto riesgo (true or false).
identification_number: Identificación del empleado.
surname: Primer apellido del empleado.
second_surname: Segundo apellido del empleado.
first_name: Nombre del empleado.
address: Dirreción del empleado.
email: Correo del empleado.
integral_salarary: Indique si es salario integral (true or false).
salary: Salario del empleado.
-
"payment" Obligatorio string
payment_method_id: ID del metodo de pago.
bank_name: Nombrel del Banco
account_type: Tipo de cuenta bancaria
account_number: Número de la cuenta bancaria.
-
"payment_dates" Obligatorio string
payment_date: Corresponde a la fecha de pago.
-
"accrued" Obligatorio string
worked_days: Corresponde a la cantidad de días laborados.
salary: Corresponde al salario del empleado.
transportation_allowance: Corresponde al auxilio de transporte.
accrued_total: Corresponde al pago total (Salario + Auxilio).
Campos OpcionalesHEDs: Corresponde a las Horas Extra Diurna.
HENs: Corresponde a las Horas Extra Nocturna.
HRNs: Corresponde a las Horas Recargo Nocturno.
HEDDFs: Corresponde a las Horas Extra Diurno Dominical y Festivo.
HRDDFs: Corresponde a las Horas Recargo Diurno Dominical y Festivo
HENDFs: Corresponde a las Horas Extra Nocturno Dominical y Festivo
HRNDFs: Corresponde a las Horas Recargo Nocturno Dominical y Festivo
common_vacation: Corresponde al campo para informar las vacaciones.
paid_vacation: Corresponde al campo vacaciones pagadas en efectivo.
service_bonus: Corresponde a las primas.
severance: Corresponde a las cesantias e interese de las cesantias.
work_disabilities: Corresponde a las incapacidades laborales, la propiedad type corresponde a la tabla type_disabilities tipos de incapacidades.
maternity_leave: Corresponde a Licencia Maternidad o Paternidad
paid_leave: Corresponde a la Licencia Remunerada
non_paid_leave: Corresponde a la Licencia No Remunerada
bonuses: Informe en este campo las Bonificaciones (No salarial) o Salariales
aid: Corresponden a los Auxilios (No salarial) y Salariales.
legal_strike: Corresponde a las huelgas Legales
other_concepts: Corresponde a Valor Pagado por Conceptos No Salariales o Salariales, debera informar el detalle del concepto en el siguiente elemento description_concept
compensations: Valor pagado por compensaciones ordinarias o extraordinarias.
epctv_bonuses: Viatico, manutención, alojamiento Salaria o no salarial
commissions: Corresponde a las comisiones devengadas por el empleado.
third_party_payments: Corresponde a los pagos a terceros beneficiarios del empleado.
advances: Corresponde a los diferentes anticipos de nómina a favor del empleado.
endowment: Corresponde a las dotaciones entregadas al empleado.
sustenance_support: Corresponde a las ayudas por sostenimiento que no constituyen salario y que se generan a favor del empleado generalmente en etapa de practicas o lectiva.
telecommuting: Corresponde a los a favor del empleado cuando el contrato es bajo la modalidad de teletrabajo.
withdrawal_bonus: Corresponde a las bonificaciones de retiro acordadas entre el empleador y el empleado.
compensation: Corresponde a las compensaciones ordinarias o extraordinarias.
compensation: Corresponde a las sumatorias de los diferentes devengados a favor del empleado.
Nota: la propiedad percentage debe ser el ID de la tabla
-
"deductions" Obligatorio string
eps_type_law_deductions_id: Corresponde al ID de la tabla deducciones de Ley para salud
eps_deduction: Corresponde al descuento por concepto de aporte a Salud por parte del empleado.
pension_type_law_deductions_id: Corresponde al ID de la tabla deducciones de Ley para pensión
pension_deduction: Corresponde al descuento por concepto de aporte a Pension por parte del empleado.
deductions_total: Corresponde al valor acumulado del total de deducciones.
Campos Opcionaleslabor_union: Corresponde a los conceptos o deducciones por sindicatos, indicando el porcentaje y el valor.
sanctions: Informe en este concepto las sanciones a cargo del empleado ya sean publicas o privadas.
orders: Corresponde a las libranzas a cargo del empleado informando el detalle y el valor.
third_party_payments: Corresponde a las deducciones a favor de terceros y que estará a cargo empleado.
advances: Corresponde a las deducciones por conceptos de anticipos de nómina.
other_deductions: Corresponde a demás deducciones a cargo del empleado.
voluntary_pension: Corresponde a los aportes voluntarios por parte del empleado al sistema de pensiones.
withholding_at_source: Corresponde a los descuentos por retenciones en la fuente.
voluntary_pension: Corresponde a los aportes voluntarios por parte del empleado al sistema de pensiones.
afc: Corresponde a las deducciones por Ahorro fomento a la construcción.
cooperative: Corresponde a las cuotas o aportes que los empleados hagan a las cooperativas legalmente constituidas
tax_liens: Corresponde a las deducciones por embargos.
supplementary_plan: Corresponde al valor de planes complementarios de salud al que el trabajador se encuentran afiliado
education: Corresponde al valor pagado correspondiente a conceptos educativos por parte del trabajador
refund: Corresponde a los reembolsos que el empleado debe pagar.
debt: Corresponde al valor que se deba pagar por las obligaciones que el empleado tenga con su empresa.
Detalle de Nomina Eliminación
{
"type_document_id": 10,
"establishment_name": "",
"establishment_address": "CLL 18A 11 - 20",
"establishment_phone": "3017882489",
"establishment_municipality": 439,
"establishment_email": "soporte@dominio.com",
"head_note": "",
"foot_note": "",
"type_note": 2,
"predecessor": {
"predecessor_number": "NI1",
"predecessor_cune": "ebfuhfu8979837hbidudbduyidhbuihdoiue8773",
"predecessor_issue_date": "2021-09-03"
},
"prefix": "NA",
"consecutive": 1,
"payroll_period_id": 4,
"notes": "PRUEBA DE ENVIO DE NOMINA DE AJUSTE ELECTRONICA - ELIMINAR"
}
Descripción - Haga click en la propiedad
-
"type_note" Obligatorio
number
En la propiedad type_note deberá indicar el tipo de nota a utilizar 1 = Reemplazo o 2 = Eliminar
-
"predecessor" Obligatorio
array
En la propiedad predecessor deberá indicar el número de la nómina, el cune y la fecha del documento a eliminar en la DIAN.
-
"prefix y consecutive" Obligatorio
array
Las propiedades prefix y consecutive corresponde al prefijo y consecutivo de las notas de ajuste y no a los de nómina
-
"payroll_period_id" Obligatorio
number
Indique el ID de la tabla correspondiente a los periodos de nómina.
Nota: las demás propiedades son opcionales y sus descripciones han sido aboradas en los componente de los otros documentos.
Detalle de Nomina Reemplazo
{
"type_document_id": 10,
"establishment_name": "",
"establishment_address": "CLL 11 NRO 21-73 BRR LA CABAÑA",
"establishment_phone": "3017882489",
"establishment_municipality": 439,
"establishment_email": "soporte@dominio.com",
"head_note": "",
"foot_note": "",
"type_note": 1,
"predecessor": {
"predecessor_number": "NI1",
"predecessor_cune": "ndjjndj8093unfbiui899283283uhneudhe73h39dj",
"predecessor_issue_date": "2021-07-28"
},
"period":{
"admision_date": "2021-01-01",
"settlement_start_date": "2021-03-01",
"settlement_end_date": "2021-03-15",
"worked_time": 15,
"issue_date": "2021-07-29"
},
"worker_code": "41946692",
"prefix": "NA",
"consecutive": 1,
"payroll_period_id": 4,
"notes": "PRUEBA DE ENVIO DE NOMINA ELECTRONICA",
"worker": {
},
"payment": {
},
"payment_dates": [
],
"accrued": {
},
"deductions": {
}
}
Descripción - Haga click en la propiedad
-
"type_note" Obligatorio
number
En la propiedad type_note deberá indicar el tipo de nota a utilizar 1 = Reemplazo o 2 = Eliminar
-
"predecessor" Obligatorio
array
En la propiedad predecessor deberá indicar el número de la nómina, el cune y la fecha del documento a eliminar en la DIAN.
-
"prefix y consecutive" Obligatorio
array
Las propiedades prefix y consecutive corresponde al prefijo y consecutivo de las notas de ajuste y no a los de nómina
-
"payroll_period_id" Obligatorio
number
Indique el ID de la tabla correspondiente a los periodos de nómina.
Nota: Esta nota puede contener todas las propiedades del documento de nómina, y para ello ustede deberá agregar los elementos que desea corregir o reemplazar los valores. VER EL JSON DE NÓMINA. Hemos simplicado el cuerpo del JSON ya que han sido detalladas en el documento de nómina pero se deberán incluir todas las propiedades completas que ustede desee ajustar.
Documento soporte de compras
Detalle de losTags
{
"number": 1,
"type_document_id": 11,
"date": "2020-10-06",
"time": "04:08:12",
"resolution_number": "18760000002",
"prefix": "DS",
"sendmail": false,
"seller": {
"identification_number": 900166483,
"dv": 1,
"name": "INVERSIONES DAVAL SAS",
"phone": 3103891693,
"address": "CLL 4 NRO 33-90",
"email": "alexanderobandolondono@gmail.com",
"merchant_registration": "0000000-00",
"type_document_identification_id": 6,
"type_organization_id": 1,
"municipality_id": 822,
"type_regime_id": 1
},
"payment_form": {
"payment_form_id": 2,
"payment_method_id": 30,
"payment_due_date": "2020-11-06",
"duration_measure": "30"
},
"allowance_charges": [
{
"discount_id": 1,
"charge_indicator": false,
"allowance_charge_reason": "DESCUENTO GENERAL",
"amount": "0.00",
"base_amount": "1000000.00"
}
],
"legal_monetary_totals": {
"line_extension_amount": "1000000.00",
"tax_exclusive_amount": "0.00",
"tax_inclusive_amount": "1000000.00",
"allowance_total_amount": "0.00",
"charge_total_amount": "0.00",
"payable_amount": "1000000.00"
},
"invoice_lines":
[
{
"unit_measure_id": 70,
"invoiced_quantity": "1",
"line_extension_amount": "1000000.00",
"free_of_charge_indicator": false,
"allowance_charges": [{
"charge_indicator": false,
"allowance_charge_reason": "DESCUENTO GENERAL",
"amount": "0.00",
"base_amount": "1000000.00"
}
],
"description": "COMISION POR SERVICIOS",
"code": "COMISION",
"type_item_identification_id": 4,
"price_amount": "1000000.00",
"base_quantity": "1"
}
]
}
Descripción - Haga click en la propiedad
-
"number" Obligatorio number
Corresponde al número del documento según el consecutivo autorizado por la DIAN
-
"type_document_id" Obligatorio number
Su valor debe ser el ID de la tabla tipo de documento electrónico
-
"date" Obligatorio date
Corresponde a la fecha del documento en formato YYYY-MM-DD y no podrá variar en más de 10 días de la fecha actual
-
"time" Obligatorio timestamp
Corresponde a la hora del documento en formato 24 horas.
-
"resolution_number" y "prefix":" Obligatorio string
Es el número de resolución y prefijo asignado por la DIAN y que previamente han sido configurados en la API.
-
"sendmail" Obligatorio booleano
Esta propiedad permite definir si se enviará de forma automatica el correo al proveedor
-
"notes" Opcional string
Permite ingresar una descripción general del documento en caso que exista.
-
"foot_note" Opcional string
Permite incluir una nota en pie de página del documento.
-
"seller" Obligatorio number | string
En la propiedad customer se deben enviar los datos del proveedor.
identification_number: corresponde al nit o cedula del proveedor en caso de ser cedula no se utiliza la propiedad dv
name: en esta propiedad se debe enviar el nombre del proveedor
phone: corresponde al teléfono del proveedor
address: deberá ir la dirección del proveedor
email: debe ir el email del vendedor
merchant_registration: se deberá enviar el número de matricula mercantil o en su defecto "0000000"
type_document_identification_id, type_organization_id, municipality_id y type_regime_id: se de utilizar los IDs correspondientes de cada tabla de acuerdo con la información suministrada.
-
"payment_form" Obligatorio number | string
En la propiedad payment_form se debe enviar el metodo y forma de pago
Las propiedades payment_form_id y payment_method_id: hacen referencia al ID de las tablas formas y métodos de pago. En la propiedad payment_due_date deberá informar la fecha de pago y finalmente en la propiedad duration_measure informará la cantidad de días de plazo en caso que sea venta a crédito.
-
"allowance_charges" Obligatorio number | string | booleano
En esta propiedad se informan descuentos o cargos a nivel de factura, es decir descuentos o cargos que no afectan las bases gravables. Los descuentos o cargos que afectan bases gravables se informan a nivel de ítem.
ChargeIndicator: Indica que el elemento es un Cargo y no un descuento
Cargo es true, es un débito aumenta el valor de la factura y se debe reportar en el LegalMonetary. Descuento es false, un crédito descuenta el valor de la factura antes de tributos y debe reportarse en el LegalMonetaryallowance_charge_reason: Texto libre para informar de la razón del descuento (Obligatorio de informar si es descuento a nivel de factura.)
amount: Es el valor de descuento
base_amount: Es la base sujeta al descuento
-
"legal_monetary_totals" Obligatorio number | string
Grupo de campos para información relacionadas con los valores totales aplicables al documento soporte
line_extension_amount: Total valor bruto, suma de los valores brutos de las líneas de el documento soporte.
tax_exclusive_amount: Total Valor Base Imponible, Base imponible para el cálculo de los tributos
tax_inclusive_amount: Total de Valor Bruto más tributos, el Valor Bruto más tributos tiene que ser igual a Valor Brutode el documento soporte que contienen el valor comercial más la suma de los tributos de todas las líneas de detalle.
allowance_total_amount: Descuento Total: Suma de todos los descuentos aplicados a nivel de el documento soporte
charge_total_amount: Cargo Total, Suma de todos los cargos aplicados a nivel de el documento soporte
payable_amount: valor de el documento soporte, valor total de ítems (incluyendo cargos y descuentos a nivel de ítems) + valor tributos + valor cargos – valor descuentos.
-
"with_holding_tax_total" Opcional number | string
Grupo de campos para información relacionadas con los valores de retenciones, estas serán a nivel informativo y no restarán al valor del documento.
tax_id: identificador del tributo (Ver tabla)
tax_amount: Valor del tributo
percent: tarifa del tributo
taxable_amount: base Imponible sobre la que se calcula el valor del tributo
-
"tax_totals" Obligatorio number | string
Grupo de campos para información relacionadas con los tributos (Impuestos)
tax_id: identificador del tributo (Ver tabla)
tax_amount: valor del tributo
percent: tarifa del tributo
taxable_amount: Base Imponible sobre la que se calcula el valor del tributo
-
"invoice_lines" Obligatorio number | float | string | booleano
Grupo de campos para información relacionadas las lineas del documento o items a facturar
unit_measure_id: Corresponde a uno de los valores de la tabla de unidades de medida
invoiced_quantity: Cantidad del producto o servicio
line_extension_amount: Valor total de la línea. Cantidad x Precio Unidad menos descuentos más recargos que apliquen para la línea.
free_of_charge_indicator: Indica que el elemento es un Cargo y no un descuento
allowance_charges: Ver expliación de los descuentos generales tiene el mismo funcionamiento pero a nivel productos o servicios
description: Descripción del producto o servicio
notes: Texto libre para añadir información adicional al artículo.
code: Código asignado al producto por el proveedor
type_item_identification_id: ver tabla tipo de productos
price_amount: ver tabla tipo de productos
base_quantity: Es la cantidad por la que se multiplicará el valor para obtener el total de la linea