Crear factura de venta

Endpoint que permite crear una factura de venta desde cero.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Objeto JSON que contiene la información de una factura de venta

string

Estado de la factura, las opciones posibles son: open o draft. Si no se envía este atributo y no se envían pagos asociados la factura se crea en "draft". Si se envían pagos a la factura, la factura queda creada en "open".

numberTemplate
object

Objeto que contiene la información de la numeración de la factura. Para numeraciones automáticas solo debe incluir el id de la numeración, para numeraciones manuales se debe enviar como mínimo el id de la numeración y el número de la factura. Si no se envía este atributo la aplicación intenta crear la factura con la numeración preferida que tiene configurada la empresa. Si no es posible retorna error.

items
array of objects
required

Array de objetos item (productos/servicios) asociados a la factura. Cada objeto debe incluir: id (number, obligatorio): identificador del producto o servicio que se vende; price (double, obligatorio): precio de venta; reference (string) : referencia del producto/servicio; description (string): descripción del producto/servicio; tax (objeto) : array de objetos tax que indican la información del impuesto; quantity (obligatorio): cantidad vendida del producto o servicio. El precio del producto/servicio no debe incluir impuestos ni descuentos.

items*
payments
array of objects

Array de objetos que indican los pagos que se han realizado a la factura. Cada objeto debe contener los siguientes atributos: date (string, obligatorio): fecha del pago. Formato yyyy-mm-dd; account (object, obligatorio): objeto que incluye el id de la cuenta banco a la cual debe ingresar el dinero; amount (number, obligatorio): valor pagado.; paymentMethod (string): método de pago, las opciones posibles son: transefer, cash, deposit, check, credit-card, debit-card; anotations (string): notas del pago; observations (string): observaciones del pago; retentions (array): array de objetos que indican las retenciones a la factura que se realizaron en el pago; currency (object): objeto que incluye la información de la moneda y la tasa de cambio asociada al pago.

payments
string

Especifica el identificador de la cotización que desea asociar a la factura de venta, de esta forma, la cotización queda facturada y se asocian los ítems que se especifiquen en el parametro items no los que tiene la cotización.

string

Términos y condiciones de la factura. Longitud máxima permitida: 500.

string

Notas de la factura, visibles en el PDF o documento impreso. Longitud máxima permitida: 500.

date
required

Fecha de vencimiento de la factura. Formato yyyy-MM-dd.

date
required

Fecha de la factura. Formato yyyy-MM-dd.

string
length ≤ 500

Observaciones de la factura (no visibles en el pdf o documento impreso). Longitud máxima permitida: 500.

client
object
required

Objecto que contiene el id del cliente asociado a la factura. Se puede enviar directamente el id del cliente en este atributo.

Objeto que indica el id del vendedor asociado a la factura. Se puede enviar directamente el id del vendedor en este atributo.

Objeto que indica el id de la lista de precios asociada a la factura. Se puede enviar directamente el id de la lista de precios en este atributo.

currency
object

Objecto que incluye la información de la moneda y tasa de cambio asociada a la factura. Solo se debe incluir si la compañía tiene activa la funcionalidad de multimoneda y tiene configurada la moneda seleccionada. Debe incluir el código de la moneda (de tres letras según ISO) y la tasa de cambio.

retentions
array of objects

Array de objetos retention que indican las retenciones de la factura de venta. Cada objeto debe contener: id (number, obligatorio): Identificador de la retención que se desea asociar a la factura; amount (double, obligatorio): valor retenido.

retentions

Objeto que indica el id de la bodega/almacén asociada a la factura. Se puede enviar directamente el id de la bodega/almacén en este atributo. Si no se envía este parámetro la factura queda asociada a la bodega/almacén Principal.

remissions
array of objects

Array de identificadores de las remisiones que se desean facturar, puedes asociar una o varias remisiones tan solo indicando el id de cada una en un array. El cliente de las remisiones y de la factura de venta debe ser el mismo. Solo las remisiones abiertas pueden ser facturadas. De esta forma, los ítems de cada una de las remisiones serán facturados, además también podrás especificar otros ítems con el parametroitems.

remissions

Objeto que indica el id del centro de costo asociado. Se puede enviar directamente el id del centro de costo en este atributo o enviarlo como objeto.

comments
array of strings

Arreglo de strings con cada uno de los comentarios que se desean asociar. Los comentarios se pueden actualizar aun si la factura de venta no se puede editar.

comments
string
enum

Indica la periodicidad de los pagos de las cuotas de la factura. Si se desea emitir la factura, la forma de pago es a crédito este atributo se vuelve obligatorio.

Allowed:
Responses

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json