{"_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"},"githubsync":"","project":"56abd2434e4b730d009eb10a","version":{"_id":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a","__v":30,"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","59e62c2a3ccab100263e800a","59e63126b4f8b0002edbe92c","5b5bbc98eaf71700031c2fda","5bedb529a56934002ee522b9","5c3e39454d3006001420f73e","5c4f5c0e1555130014796daa","5c6ac741acb04f003f927fa7","5c7e9c7c412d4c003f750162","5d055915910ab30020e5bc06","5d76e2018e0ce7006c82dbe1","5d9ca92eac34370012872d08","5d9f8149103b9f006c1421e0"],"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":10,"metadata":{"title":"","description":"","image":[]},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-07-27T19:34:48.560Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"method":"put","results":{"codes":[{"code":"","language":"text"}]},"settings":"","auth":"required","params":[{"_id":"57990cd8b8d3432000fdffb9","ref":"","in":"path","required":true,"desc":"Identificador de la factura de venta que se desea editar.","default":"","type":"int","name":"id"},{"_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":"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":"5a01debe5c56100028a94f08","ref":"","in":"body","required":false,"desc":"Para México, representa la clave del Uso CFDI.","default":"","type":"string","name":"cfdiUse"},{"_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"},{"_id":"5a707984b3c9580024d1a37d","ref":"","in":"body","required":false,"desc":"Para México, representa la forma de pago de la factura.  Las opciones posibles son: `cash`  Efectivo,  `debit-card` Tarjeta débito, `credit-card` Tarjeta de crédito,  `service-card` Tarjeta de servicio, `transfer` Transferencia electónica, `check` Cheque nominativo, `electronic-wallet` Monedero electrónico, `electronic-money` Dinero electrónico, `grocery-voucher` Vale de despensa. Si el paymentType es \"PPD\" solo admite el paymentMethod `other` Por Definir.","default":"","type":"string","name":"paymentMethod"},{"_id":"5a707984b3c9580024d1a37c","ref":"","in":"body","required":false,"desc":"Para México, representa el método de la factura. Admite los valores `PUE` para Pago en Una sola Exhibición y `PPD` para Pago en Parcialidades o Diferido.","default":"","type":"string","name":"paymentType"},{"_id":"5c2ccfa7ff65cd001f15b3bc","ref":"","in":"body","required":false,"desc":"Para Costa Rica, indica la condición de la venta.  Las opciones posibles son: `01`  Venta de contado,  `02`  Venta a crédito, `03`  Consignación, `04`  Apartado, `05`  Arrendamiento con opción de compra, `06`  Arrendamiento en función financiera, `99`  Otras condiciones de venta. Si se desea emitir la factura, este atributo se vuelve obligatorio.","default":"","type":"string","name":"saleCondition (Costa rica)"},{"_id":"5c2ccfa7ff65cd001f15b3bb","ref":"","in":"body","required":false,"desc":"Para Perú, indica el tipo de operación de la venta. Consulta el catálogo de parámetros correspondiente a cada país haciendo clic [aquí](https://developer.alegra.com/docs/perú).","default":"","type":"string","name":"operationType (Perú)"},{"_id":"5d684915c00ee40207053f79","ref":"","in":"body","required":false,"desc":"Para Costa Rica, indica el código de la actividad económica asociada a la factura.","default":"","type":"int","name":"economicActivity (Costa Rica)"},{"_id":"5dae1e79b6986c00502faac6","ref":"","in":"body","required":false,"desc":"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 parametro`items`.","default":"","type":"array_int","name":"remissions"}],"url":"/invoices/:id"},"isReference":true,"order":4,"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.
cfdiUse:
string
Para México, representa la clave del Uso CFDI.
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.
paymentMethod:
string
Para México, representa la forma de pago de la factura. Las opciones posibles son: `cash` Efectivo, `debit-card` Tarjeta débito, `credit-card` Tarjeta de crédito, `service-card` Tarjeta de servicio, `transfer` Transferencia electónica, `check` Cheque nominativo, `electronic-wallet` Monedero electrónico, `electronic-money` Dinero electrónico, `grocery-voucher` Vale de despensa. Si el paymentType es "PPD" solo admite el paymentMethod `other` Por Definir.
paymentType:
string
Para México, representa el método de la factura. Admite los valores `PUE` para Pago en Una sola Exhibición y `PPD` para Pago en Parcialidades o Diferido.
saleCondition:
string
Para Costa Rica, indica la condición de la venta. Las opciones posibles son: `01` Venta de contado, `02` Venta a crédito, `03` Consignación, `04` Apartado, `05` Arrendamiento con opción de compra, `06` Arrendamiento en función financiera, `99` Otras condiciones de venta. Si se desea emitir la factura, este atributo se vuelve obligatorio.
operationType:
string
Para Perú, indica el tipo de operación de la venta. Consulta el catálogo de parámetros correspondiente a cada país haciendo clic [aquí](https://developer.alegra.com/docs/perú).
economicActivity:
integer
Para Costa Rica, indica el código de la actividad económica asociada a la factura.
remissions:
array of integers
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 parametro`items`.

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 }}