Campos base
Section titled “Campos base”type_document_id: Tipo de documento, para documento soporte siempre sera id 11
number: Número de documento soporte
date: Fecha de emisión (YYYY-MM-DD)
time: Hora de emisión (HH:MM:SS)
resolution_number: Número de resolución
prefix: Prefijo del documento soporte
notes: Notas del documento soporte
establishment_name: Nombre del establecimiento
sendmail: Esta propiedad permite definir si se enviará de forma automatica el correo al cliente
sendmailtome: Esta propiedad permite definir si se enviará de forma automatica el documento al correo del emisor, recibe true o false
email_cc_list: Permite definir un lista de email a los que será enviado un documento de forma simultanea
head_note (string): Permite incluir una nota en la cabezera del documento.
foot_note (string): Permite incluir una nota en pie de página del documento.
logo_empresa_emisora (base64): Logo de la empresa emisora en formato base64
legal_monetary_totals (array): Grupo de campos para información relacionadas con los valores totales aplicables a la factura
legal_monetary_totals->line_extension_amount (float): Total valor bruto: corresponde a la suma de los valores brutos de las líneas de la factura
legal_monetary_totals->tax_exclusive_amount (float): Total Valor Base Imponible: Base imponible para el cálculo de los tributos (La suma de las bases de todas lineas con impuestos)
legal_monetary_totals->tax_inclusive_amount (float): Total de Valor Bruto de todas las lineas más tributos menos los descuentos (Productos con impuestos, más productos sin impuestos, más los impuestos, menos los descuentos)
legal_monetary_totals->allowance_total_amount (float): Descuento Total: Suma de todos los descuentos aplicados a nivel de la factura
legal_monetary_totals->charge_total_amount (float): Cargo Total, Suma de todos los cargos aplicados a nivel de la factura
legal_monetary_totals->payable_amount (float): Valor a pagar de la factura, valor total de ítems (incluyendo cargos y descuentos a nivel de ítems) + valor tributos + valor cargos – valor descuentos.
payment_form (array): En la propiedad payment_form se debe enviar el metodo y forma de pago
payment_form->payment_form_id (number): Identificador de las formas de pago (Ver tabla Formas de pago)
payment_form->payment_method_id (number): Identificador de los metodos de pago (Ver tabla Metodos de pago)
payment_form->payment_due_date (date): deberá informar la fecha de pago. Es obligatorio cuando el método de pago es a crédito
payment_form->duration_measure (number): informará la cantidad de días de plazo en caso que sea venta a crédito. Es obligatorio cuando el método de pago es a crédito
payment_form->payment_means_id (number): informará la cantidad de días de plazo en caso que sea venta a crédito. Es obligatorio cuando el método de pago es a crédito
Información del establecimiento
Section titled “Información del establecimiento”Habilitar envio de correos
Section titled “Habilitar envio de correos”Archivos adjuntos
Section titled “Archivos adjuntos”Valores totales de la factura
Section titled “Valores totales de la factura”Forma de pago
Section titled “Forma de pago”Información del proveedor
Section titled “Información del proveedor”seller (array): En la propiedad seller se deben enviar los datos del proveedor.
seller->type_document_identification_id (number): identificador del tipo de documento de identificación (Ver tabla Tipos de Documentos de Identificación)
seller->identification_number (string): Corresponde al nit o cedula del proveedor en caso de ser cedula no se utiliza la propiedad dv
seller->dv (number): en esta propiedad se debe enviar el digito de vertificación cuando sea nit el documento
seller->name (string): en esta propiedad se debe enviar el nombre o razón social del proveedor
seller->postal_zone_code (string): en esta propiedad se debe enviar el código postal del proveedor
seller->email (string): debe ir el email al cual será enviada la factura del proveedor
seller->phone (string): corresponde al teléfono del proveedor
seller->address (string): deberá ir la dirección del proveedor
seller->merchant_registration (string): se deberá enviar el número de matricula mercantil o en su defecto 0000000
seller->type_organization_id (number): identificador del tipo de organización (Ver tabla Tipos de Organizaciones)
seller->municipality_id (number): identificador del municipio (Ver tabla Municipios)
seller->type_regime_id (number): identificador del régimen (Ver tabla Régimen)
seller->type_liability_id (number): identificador del tipo de responsabilidad (Ver tabla Tipos de Responsabilidades)
seller->tax_id (number): identificador del tipo de impuesto (Ver tabla de Impuestos)
Campos por linea de factura
Section titled “Campos por linea de factura”invoice_lines (array): Grupo de campos para información relacionadas las lineas del documento o items a facturar
invoice_lines->unit_measure_id (number): identificador de las unidades de medidas (Ver tabla Unidades de Medidas)
invoice_lines->invoiced_quantity (number): Cantidad del producto o servicio
invoice_lines->line_extension_amount (float): Valor total de la línea. Cantidad x Precio Unidad menos descuentos más recargos que apliquen para la línea.
invoice_lines->free_of_charge_indicator (boolean): Indica que el elemento es un Cargo y no un descuento
invoice_lines->allowance_charges (array): Ver expliación de los descuentos generales tiene el mismo funcionamiento pero a nivel productos o servicios
invoice_lines->description (string): Descripción del producto o servicio
invoice_lines->notes (string): Texto libre para añadir información adicional al artículo.
invoice_lines->code (string): Código asignado al producto por el cliente
invoice_lines->type_item_identification_id (number):Indentificador de tipo de producto (Ver tabla Tipos de Productos)
invoice_lines->type_generation_transmition_id (number):Indentificador de tipo de generación de transmisión, indica si el documento soporte es unitario o la suma de varias operaciones al mismo proveedor (Ver tabla Tipos de Generación de Transmisión)
invoice_lines->start_date (date):Si es una sola compra, indique la fecha actual en caso contrario debe reporta la fecha de la primera compra de un total de varias. (esta fecha no debe ser mayor a 6 días).
invoice_lines->price_amount (float):Valor de la linea de la factura
invoice_lines->base_quantity (float):Es la cantidad por la que se multiplicará el valor para obtener el total de la linea
Campos impuestos
Section titled “Campos impuestos”tax_totals (array): Grupo de campos para información relacionadas con los tributos (Impuestos).
tax_totals->tax_id (number): identificador del tributo (Ver tabla Impuestos)
tax_totals->tax_amount (float): Valor del tributo (impuesto)
tax_totals->percent (float): Tarifa del tributo
tax_totals->taxable_amount (float): base Imponible sobre la que se calcula el valor del tributo (La suma de los line_extension_amount de productos con impuestos)
Campos de descuentos
Section titled “Campos de descuentos”allowance_charges (array): 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.
allowance_charges->charge_indicator (boolean): indica si es un cargo o un descuento
allowance_charges->discount_id (number): es el identificador perteneciente al tipo de descuento
allowance_charges->amount (float): Es el valor de descuento
allowance_charges->base_amount (float): Es la base sujeta al descuento
allowance_charges->allowance_charge_reason (string): Texto libre para informar de la razón del descuento (Obligatorio de informar si es descuento a nivel de factura)