{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/invoices/:id","auth":"required","examples":{"codes":[{"name":"Factura de Venta","language":"json","code":"{\n\t\"date\": \"2015-11-15\",\n\t\"dueDate\": \"2015-12-15\",\n\t\"client\":  2,\n\t\"items\" : [\n   \t{\n\t\t  \"id\": 2,\n\t\t\t\"price\" : 30,\n\t\t\t\"quantity\" : 10,\n\t\t\t\"importRequest\": \"\"\n    }\n   ],\n   \"remissions\":[27],\n   \"priceList\":1\n}"}]},"method":"put","params":[{"name":"id","type":"int","default":"","desc":"Identificador de la factura de venta que se desea editar.","required":true,"in":"path","ref":"","_id":"57990cd8b8d3432000fdffb9"},{"name":"termsConditions","type":"string","default":"","desc":"Términos y condiciones de la factura. Longitud máxima permitida: 500.","required":false,"in":"body","ref":"","_id":"56b0cd936d004b17008065cc"},{"name":"numberTemplate","type":"mixed","default":"","desc":"Objeto que contiene la información de la numeración de la factura.","required":false,"in":"body","ref":"","_id":"56b210797ae4550d00062925"},{"name":"items","type":"array_object","default":"","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.","required":false,"in":"body","ref":"","_id":"56b210797ae4550d00062924"},{"name":"anotation","type":"string","default":"","desc":"Notas de la factura, visibles en el PDF o documento impreso. Longitud máxima permitida: 500.","required":false,"in":"body","ref":"","_id":"56b0cd936d004b17008065cd"},{"name":"dueDate","type":"yyyy-mm-dd","default":"","desc":"Fecha de vencimiento de la factura. Formato yyyy-MM-dd.","required":false,"in":"body","ref":"","_id":"56b0cd936d004b17008065cf"},{"name":"date","type":"yyyy-mm-dd","default":"","desc":"Fecha de la factura. Formato yyyy-MM-dd.","required":false,"in":"body","ref":"","_id":"56b0cbcbce5f410d0056c9c7"},{"name":"observations","type":"string","default":"","desc":"Observaciones de la factura (no visibles en el pdf o documento impreso). Longitud máxima permitida: 500.","required":false,"in":"body","ref":"","_id":"56b0cd936d004b17008065ce"},{"name":"client","type":"mixed","default":"","desc":"Objecto que contiene el id del cliente asociado a la factura. Se puede enviar directamente el id del cliente en este atributo.","required":false,"in":"body","ref":"","_id":"56b0cd936d004b17008065ca"},{"name":"seller","type":"mixed","default":"","desc":"Objeto que indica el id del vendedor asociado a la factura. Se puede enviar directamente el id del vendedor en este atributo.","required":false,"in":"body","ref":"","_id":"56b210797ae4550d00062922"},{"name":"priceList","type":"mixed","default":"","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.","required":false,"in":"body","ref":"","_id":"56b210797ae4550d00062921"},{"name":"currency","type":"object","default":"","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.","required":false,"in":"body","ref":"","_id":"56b210cf3b6f690d00bdb6a9"},{"name":"retentions","type":"array_object","default":"","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.","required":false,"in":"body","ref":"","_id":"56b210797ae4550d00062923"},{"name":"cfdiUse","type":"string","default":"","desc":"Para México, representa la clave del Uso CFDI.","required":false,"in":"body","ref":"","_id":"5a01debe5c56100028a94f08"},{"name":"warehouse","type":"mixed","default":"","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.","required":false,"in":"body","ref":"","_id":"5949a0028e4543001a87b048"},{"name":"paymentMethod","type":"string","default":"","desc":"Para México, representa la forma de pago de la factura.  Las opciones posibles son: `cash` Efectivo, `debit-card` Tarjeta de débito, `credit-card` Tarjeta de crédito, `service-card` Tarjeta de servicios, `transfer` Transferencia electrónica de fondos, `check` Cheque nominativo, `electronic-wallet` Monedero electrónico, `electronic-money` Dinero electrónico, `grocery-voucher` Vale de despensa, `dation-payment` Dación en pago, `subrogation-payment` Pago por subrogación, `allocation-payment` Pago por consignación, `forgiveness` Condonación, `compensation` Compensación, `novation` Novación, `misunderstanding` Confusión, `debt-remission` Remisión de deuda, `prescription-or-expiration` Prescripción o caducidad, `creditor-satisfaction` A satisfacción del acreedor. Si el paymentType es \"PPD\" solo admite el paymentMethod `other` Por Definir.","required":false,"in":"body","ref":"","_id":"5a707984b3c9580024d1a37d"},{"name":"paymentForm (Chile)","type":"object","default":"","desc":"Para Chile, el objeto paymentForm indica la forma de pago de la factura, este objeto puede contener atributos:  * `id (string)` código de la forma de pago y * `value(string)` nombre de la forma de pago. Si se desea emitir la factura, este atributo se vuelve obligatorio.","required":false,"in":"body","ref":"","_id":"5e6013701588a800575d6886"},{"name":"paymentType","type":"string","default":"","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.","required":false,"in":"body","ref":"","_id":"5a707984b3c9580024d1a37c"},{"name":"saleCondition (Costa rica)","type":"string","default":"","desc":"Para Costa Rica, indica la condición de la venta. Consulta el catálogo de parámetros correspondiente a cada país haciendo clic [aquí](https://developer.alegra.com/docs/costa-rica).. Si se desea emitir la factura, este atributo se vuelve obligatorio.","required":false,"in":"body","ref":"","_id":"5c2ccfa7ff65cd001f15b3bc"},{"name":"stamp (Argentina)","type":"object","default":"","desc":"Para Argentina, el objeto stamp indica que se desea emitir la factura en Alegra.  Si se desea emitir la factura en Alegra, se debe enviar este objeto con los siguientes atributos :  * `generateStamp (boolean)` : Enviar en true para indicar que se desea emitir la factura en la aplicación.  Nota: Se debe tener en cuenta que si se desea expedir una factura por medio de la API y el proceso no resulta exitoso, la aplicación crea la factura en estado borrador, retorna un código HTTP 400 (Request malo) y en la respuesta se envía el error obtenido al intentar expedir la factura junto con la factura creada.","required":false,"in":"body","ref":"","_id":"5dd6f122aff7bb001807abf5"},{"name":"operationType (Perú)","type":"string","default":"","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ú).","required":false,"in":"body","ref":"","_id":"5c2ccfa7ff65cd001f15b3bb"},{"name":"economicActivity (Costa Rica)","type":"int","default":"","desc":"Para Costa Rica, indica el código de la actividad económica asociada a la factura.","required":false,"in":"body","ref":"","_id":"5d684915c00ee40207053f79"},{"name":"economicActivity (Chile)","type":"object","default":"","desc":"Para Chile, el objeto economicActivity indica la forma de pago de la factura, este objeto puede contener atributos:  * `id (string)` código de la actividad económica y * `value(string)` nombre de la actividad económica. Si no es envía este atributo, se enviará la actividad económica de la compañía.","required":false,"in":"body","ref":"","_id":"5e6013701588a800575d6880"},{"name":"remissions","type":"array_int","default":"","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`.","required":false,"in":"body","ref":"","_id":"5dae1e79b6986c00502faac6"},{"name":"saleConcept (Argentina)","type":"string","default":"","desc":"Para Argentina, indica el concepto de venta asociado a la factura. Las opciones posibles son:  `PRODUCTS` Productos, `SERVICES` Servicios, `PRODUCTS_SERVICES` Productos y Servicios. Si se desea emitir la factura, este atributo se vuelve obligatorio.","required":false,"in":"body","ref":"","_id":"5dd6f122aff7bb001807abf4"},{"name":"startDateService (Argentina)","type":"yyyy-mm-dd","default":"","desc":"Para Argentina, indica la fecha de inicio de la factura.Si se desea emitir la factura, este atributo se vuelve obligatorio.","required":false,"in":"body","ref":"","_id":"5dd6f122aff7bb001807abf3"},{"name":"endDateService (Argentina)","type":"yyyy-mm-dd","default":"","desc":"Para Argentina, indica la fecha final de la factura. Si se desea emitir la factura, este atributo se vuelve obligatorio.","required":false,"in":"body","ref":"","_id":"5dd6f122aff7bb001807abf2"}],"results":{"codes":[{"language":"text","code":""}]},"settings":""},"next":{"description":"","pages":[]},"title":"Editar factura de venta","type":"endpoint","slug":"editar-factura-de-venta","excerpt":"","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.","updates":[],"order":4,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"57990cd8b8d3432000fdffb8","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Facturas de venta","slug":"facturas-de-venta","order":3,"from_sync":false,"reference":true,"_id":"56b4b32deed075230097d689","__v":0,"project":"56abd2434e4b730d009eb10a","createdAt":"2016-02-05T14:35:25.879Z","version":"56abd2434e4b730d009eb10d"},"githubsync":"","project":"56abd2434e4b730d009eb10a","version":{"version":"1","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"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","5e3098aba5919200612d0c33","5e8ca028538a310018ccd2df"],"_id":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a","releaseDate":"2016-01-29T20:57:39.712Z","__v":32,"createdAt":"2016-01-29T20:57:39.712Z"},"createdAt":"2016-07-27T19:34:48.560Z","parentDoc":null,"user":"56abd213d4432d1900eed227","__v":15}

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 de débito, `credit-card` Tarjeta de crédito, `service-card` Tarjeta de servicios, `transfer` Transferencia electrónica de fondos, `check` Cheque nominativo, `electronic-wallet` Monedero electrónico, `electronic-money` Dinero electrónico, `grocery-voucher` Vale de despensa, `dation-payment` Dación en pago, `subrogation-payment` Pago por subrogación, `allocation-payment` Pago por consignación, `forgiveness` Condonación, `compensation` Compensación, `novation` Novación, `misunderstanding` Confusión, `debt-remission` Remisión de deuda, `prescription-or-expiration` Prescripción o caducidad, `creditor-satisfaction` A satisfacción del acreedor. Si el paymentType es "PPD" solo admite el paymentMethod `other` Por Definir.
paymentForm:
object
Para Chile, el objeto paymentForm indica la forma de pago de la factura, este objeto puede contener atributos: * `id (string)` código de la forma de pago y * `value(string)` nombre de la forma de pago. Si se desea emitir la factura, este atributo se vuelve obligatorio.
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. Consulta el catálogo de parámetros correspondiente a cada país haciendo clic [aquí](https://developer.alegra.com/docs/costa-rica).. Si se desea emitir la factura, este atributo se vuelve obligatorio.
stamp:
object
Para Argentina, el objeto stamp indica que se desea emitir la factura en Alegra. Si se desea emitir la factura en Alegra, se debe enviar este objeto con los siguientes atributos : * `generateStamp (boolean)` : Enviar en true para indicar que se desea emitir la factura en la aplicación. Nota: Se debe tener en cuenta que si se desea expedir una factura por medio de la API y el proceso no resulta exitoso, la aplicación crea la factura en estado borrador, retorna un código HTTP 400 (Request malo) y en la respuesta se envía el error obtenido al intentar expedir la factura junto con la factura creada.
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.
economicActivity:
object
Para Chile, el objeto economicActivity indica la forma de pago de la factura, este objeto puede contener atributos: * `id (string)` código de la actividad económica y * `value(string)` nombre de la actividad económica. Si no es envía este atributo, se enviará la actividad económica de la compañía.
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`.
saleConcept:
string
Para Argentina, indica el concepto de venta asociado a la factura. Las opciones posibles son: `PRODUCTS` Productos, `SERVICES` Servicios, `PRODUCTS_SERVICES` Productos y Servicios. Si se desea emitir la factura, este atributo se vuelve obligatorio.
startDateService:
yyyy-mm-dd
Para Argentina, indica la fecha de inicio de la factura.Si se desea emitir la factura, este atributo se vuelve obligatorio.
endDateService:
yyyy-mm-dd
Para Argentina, indica la fecha final de la factura. Si se desea emitir la factura, este atributo se vuelve obligatorio.

Examples


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