{"_id":"57990cd8b8d3432000fdffb8","category":{"_id":"56b4b32deed075230097d689","__v":0,"project":"56abd2434e4b730d009eb10a","version":"56abd2434e4b730d009eb10d","pages":[],"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2016-02-05T14:35:25.879Z","from_sync":false,"order":3,"slug":"facturas-de-venta","title":"Facturas de venta"},"project":"56abd2434e4b730d009eb10a","version":{"_id":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a","__v":18,"createdAt":"2016-01-29T20:57:39.712Z","releaseDate":"2016-01-29T20:57:39.712Z","categories":["56abd2444e4b730d009eb10e","56abd4c8f25f160d00e17f81","56abd72ff25f160d00e17f84","56b3b8ea9f97020d0012d936","56b3b91ac25dea2b00b0cac9","56b4b2faeed075230097d688","56b4b32deed075230097d689","56b4b37327d9c00d005d6bc4","56b4b3bf3d5f130d00dad120","56b4b3d9eed075230097d68a","56b4b3eb7bccae0d00e9a12e","56b4b4085997532100bc6b61","56fbce6e2885e80e006c855f","5739ed9aad40e23200f674b6","573dd672b3f88f0e00dcae1c","58ad0922e570c62500512a82","58ad092b55018f1900218fda","58e412a5aa544d1b0005f7da"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1"},"parentDoc":null,"user":"56abd213d4432d1900eed227","__v":4,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-07-27T19:34:48.560Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"method":"put","results":{"codes":[{"code":"","language":"text"}]},"settings":"","auth":"required","params":[{"_id":"56b0cd936d004b17008065cc","ref":"","in":"body","required":false,"desc":"Términos y condiciones de la factura. Longitud máxima permitida: 500.","default":"","type":"string","name":"termsConditions"},{"_id":"56b210797ae4550d00062925","ref":"","in":"body","required":false,"desc":"Objeto que contiene la información de la numeración de la factura.","default":"","type":"mixed","name":"numberTemplate"},{"_id":"56b210797ae4550d00062924","ref":"","in":"body","required":false,"desc":"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.","default":"","type":"array_object","name":"items"},{"_id":"57990cd8b8d3432000fdffb9","ref":"","in":"path","required":true,"desc":"Identificador de la factura de venta que se desea editar.","default":"","type":"int","name":"id"},{"_id":"56b0cd936d004b17008065cd","ref":"","in":"body","required":false,"desc":"Notas de la factura, visibles en el PDF o documento impreso. Longitud máxima permitida: 500.","default":"","type":"string","name":"anotation"},{"_id":"56b0cd936d004b17008065cf","ref":"","in":"body","required":false,"desc":"Fecha de vencimiento de la factura. Formato yyyy-MM-dd.","default":"","type":"yyyy-mm-dd","name":"dueDate"},{"_id":"56b0cbcbce5f410d0056c9c7","ref":"","in":"body","required":false,"desc":"Fecha de la factura. Formato yyyy-MM-dd.","default":"","type":"yyyy-mm-dd","name":"date"},{"_id":"56b0cd936d004b17008065ce","ref":"","in":"body","required":false,"desc":"Observaciones de la factura (no visibles en el pdf o documento impreso). Longitud máxima permitida: 500.","default":"","type":"string","name":"observations"},{"_id":"56b0cd936d004b17008065ca","ref":"","in":"body","required":false,"desc":"Objecto que contiene el id del cliente asociado a la factura. Se puede enviar directamente el id del cliente en este atributo.","default":"","type":"mixed","name":"client"},{"_id":"56b210797ae4550d00062922","ref":"","in":"body","required":false,"desc":"Objeto que indica el id del vendedor asociado a la factura. Se puede enviar directamente el id del vendedor en este atributo.","default":"","type":"mixed","name":"seller"},{"_id":"56b210797ae4550d00062921","ref":"","in":"body","required":false,"desc":"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.","default":"","type":"mixed","name":"priceList"},{"_id":"56b210cf3b6f690d00bdb6a9","ref":"","in":"body","required":false,"desc":"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.","default":"","type":"object","name":"currency"},{"_id":"56b210797ae4550d00062923","ref":"","in":"body","required":false,"desc":"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.","default":"","type":"array_object","name":"retentions"},{"_id":"5949a0028e4543001a87b048","ref":"","in":"body","required":false,"desc":"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.","default":"","type":"mixed","name":"warehouse"}],"url":"/invoices/:id"},"isReference":true,"order":5,"body":"[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Únicamente se modifican los atributos que se envían en el request, los otros atributos del objeto que no se envían quedan intactos.\"\n}\n[/block]\nPor ejemplo para editar la fecha de creación de una factura de venta se debe enviar el siguiente JSON:\n\n```\n{\n\"date\" : \"2016-06-27\"\n}```\n\nPara eliminar algún dato de la factura de venta enviar el atributo en null, así:\n```\n{\n\"observations\" : null\n}```\n\nSe retorna la factura de venta que se ha modificado.","excerpt":"","slug":"editar-factura-de-venta","type":"endpoint","title":"Editar factura de venta"}

putEditar factura de venta


Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

id:
required
integer
Identificador de la factura de venta que se desea editar.

Body Params

termsConditions:
string
Términos y condiciones de la factura. Longitud máxima permitida: 500.
numberTemplate:
mixed
Objeto que contiene la información de la numeración de la factura.
items:
array of objects
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.
anotation:
string
Notas de la factura, visibles en el PDF o documento impreso. Longitud máxima permitida: 500.
dueDate:
yyyy-mm-dd
Fecha de vencimiento de la factura. Formato yyyy-MM-dd.
date:
yyyy-mm-dd
Fecha de la factura. Formato yyyy-MM-dd.
observations:
string
Observaciones de la factura (no visibles en el pdf o documento impreso). Longitud máxima permitida: 500.
client:
mixed
Objecto que contiene el id del cliente asociado a la factura. Se puede enviar directamente el id del cliente en este atributo.
seller:
mixed
Objeto que indica el id del vendedor asociado a la factura. Se puede enviar directamente el id del vendedor en este atributo.
priceList:
mixed
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.
warehouse:
mixed
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.

Documentation

[block:callout] { "type": "warning", "title": "Únicamente se modifican los atributos que se envían en el request, los otros atributos del objeto que no se envían quedan intactos." } [/block] Por ejemplo para editar la fecha de creación de una factura de venta se debe enviar el siguiente JSON: ``` { "date" : "2016-06-27" }``` Para eliminar algún dato de la factura de venta enviar el atributo en null, así: ``` { "observations" : null }``` Se retorna la factura de venta que se ha modificado.

User Information

Try It Out

put
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}