Campos base
Section titled “Campos base”type_document_id: Tipo de documento, para documento equivalente debe verificar en la tabla de Tipos de Documentos de acuerdo al documento a enviar
number: Número de documento equivalente
date: Fecha de emisión (YYYY-MM-DD)
time: Hora de emisión (HH:MM:SS)
resolution_number: Número de resolución
postal_zone_code: Código postal del establecimiento
prefix: Prefijo del documento equivalente
software_manufacturer (array): Grupo de campos para información relacionadas con los datos del fabricante del software
software_manufacturer->name (string): Nombre del fabricante del software
software_manufacturer->business_name (string): Nombre comercial del fabricante del software
software_manufacturer->software_name (string): Nombre del software
buyer_benefits (array): Grupo de campos para información relacionadas con los datos del comprador
buyer_benefits->code (string): Número de identificación del comprador
buyer_benefits->name (string): Nombre del comprador
buyer_benefits->points (string): Puntos del comprador (Si no maneja puntos puede enviarlo en cero)
cash_information (array): Grupo de campos para información relacionadas con la caja registradora
cash_information->plate_number (string): Número de placa de la caja registradora
cash_information->location (string): Ubicación de la caja registradora
cash_information->cashier (string): Nombre del cajero que emite el documento
cash_information->cash_type (string):Tipo de caja registradora definida por el establecimiento
cash_information->subtotal (string):Subtotal de la venta
notes: Notas del documento equivalente
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.
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 fabricante del software
Section titled “Información del fabricante del software”Información del comprador
Section titled “Información del comprador”Información de la caja registradora
Section titled “Información de la caja registradora”Información del establecimiento
Section titled “Información del establecimiento”Habilitar envio de correos
Section titled “Habilitar envio de correos”Valores totales de la factura
Section titled “Valores totales de la factura”Forma de pago
Section titled “Forma de pago”Información del cliente
Section titled “Información del cliente”customer (array): En la propiedad customer se deben enviar los datos del cliente.
customer->type_document_identification_id (number): identificador del tipo de documento de identificación (Ver tabla Tipos de Documentos de Identificación)
customer->identification_number (string): Corresponde al nit o cedula del cliente en caso de ser cedula no se utiliza la propiedad dv
customer->dv (number): en esta propiedad se debe enviar el digito de vertificación cuando sea nit el documento
customer->name (string): en esta propiedad se debe enviar el nombre o razón social del cliente
customer->postal_zone_code (string): en esta propiedad se debe enviar el código postal del cliente
customer->email (string): debe ir el email al cual será enviada la factura del cliente
customer->phone (string): corresponde al teléfono del cliente
customer->address (string): deberá ir la dirección del cliente
customer->merchant_registration (string): se deberá enviar el número de matricula mercantil o en su defecto 0000000
customer->type_organization_id (number): identificador del tipo de organización (Ver tabla Tipos de Organizaciones)
customer->municipality_id (number): identificador del municipio (Ver tabla Municipios)
customer->type_regime_id (number): identificador del régimen (Ver tabla Régimen)
customer->type_liability_id (number): identificador del tipo de responsabilidad (Ver tabla Tipos de Responsabilidades)
customer->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)