{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/bills/:id","auth":"required","method":"put","examples":{"codes":[]},"results":{"codes":[]},"settings":"","params":[{"name":"id","type":"int","default":"","desc":"Id de la factura de proveedor que se desea editar.","required":true,"in":"path","ref":"","_id":"5c7ea38633a210000ef9d9f2"},{"name":"date","type":"yyyy-mm-dd","default":"","desc":"Fecha de la factura de proveedor. Formato yyyy-MM-dd.","required":false,"in":"body","ref":"","_id":"5c7ea91133a210000ef9dd1b"},{"name":"dueDate","type":"yyyy-mm-dd","default":"","desc":"Fecha de vencimiento de la factura de proveedor. Formato yyyy-MM-dd.","required":false,"in":"body","ref":"","_id":"5c7ea91133a210000ef9dd1a"},{"name":"observations","type":"string","default":"","desc":"Observaciones de la factura de proveedor (no visibles en el pdf o documento impreso). Longitud máxima permitida: 500.","required":false,"in":"body","ref":"","_id":"5c7ea91133a210000ef9dd19"},{"name":"termsConditions","type":"string","default":"","desc":"Términos y condiciones de la factura de proveedor. Longitud máxima permitida: 500.","required":false,"in":"body","ref":"","_id":"5c7ea91133a210000ef9dd18"},{"name":"numberTemplate","type":"object","default":"","desc":"Objeto que contiene la información de la numeración de la factura de proveedor. El objeto debe contener el campo `number` con el número de factura. Para la versión Dominicana se pueden incluir los campos `prefix` con el prefijo e  `informalProvider` con el valor true o false","required":false,"in":"body","ref":"","_id":"5c7ea91133a210000ef9dd17"},{"name":"subjectToProportionality (Dominicana)","type":"boolean","default":"","desc":"Para Dominicana","required":false,"in":"body","ref":"","_id":"5c7ea91133a210000ef9dd16"},{"name":"provider","type":"mixed","default":"","desc":"Objecto que contiene el id del proveedor asociado a la factura. Se puede enviar directamente el id del proveedor en este atributo.","required":false,"in":"body","ref":"","_id":"5c7ea91133a210000ef9dd15"},{"name":"currency","type":"object","default":"","desc":"Objecto que incluye la información de la moneda y tasa de cambio asociada a la factura de proveedor. 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":"5c7ea91133a210000ef9dd14"},{"name":"warehouse","type":"mixed","default":"","desc":"Objeto que indica el id de la bodega/almacén asociada a la factura de proveedor. 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":"5c7ea91133a210000ef9dd13"},{"name":"retentions","type":"array_object","default":"","desc":"Array de objetos retention que indican las retenciones de la factura de proveedor. 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":"5c7ea91133a210000ef9dd12"},{"name":"purchases","type":"object","default":"","desc":"Objetos con los ítems y categorías comprados en la factura de proveedor. `items (array_object)`: Contiene los ítems asociados a la factura. Cada objeto ítem debe incluir: `id (number, obligatorio)`: identificador del ítem que se compra; `price (double, obligatorio)`: precio de compra del ítem; `discount (double)`: valor del descuento; `quantity (number, obligatorio)`: cantidad comprada del ítem; `observations (string)` : observaciones del ítem; `tax (array)` : array de objetos tax que indican la información del impuesto; Cada objeto categoría debe incluir: `id (number, obligatorio)`: identificador de la categoría que se compra; `price (double, obligatorio)`: precio de compra de la categoría; `discount (double)`: valor del descuento; `quantity (number, obligatorio)`: cantidad comprada de la categoría; `observations (string)` : observaciones de la categoría; `tax (array)` : array de objetos tax que indican la información del impuesto","required":false,"in":"body","ref":"","_id":"5c7ea91133a210000ef9dd11"},{"name":"costCenter","type":"mixed","default":"","desc":"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.","required":false,"in":"body","ref":"","_id":"5ea9ea9bcc5e12004617808c"},{"name":"comments","type":"array_string","default":"","desc":"Arreglo de strings con cada uno de los comentarios que se desean asociar. Los comentarios se pueden actualizar aun si la factura de proveedor no se puede editar.","required":false,"in":"body","ref":"","_id":"5f4fb90bcfd1ee0020acfb9c"}]},"next":{"description":"","pages":[]},"title":"Editar factura de proveedor","type":"endpoint","slug":"editar-factura-de-proveedor","excerpt":"","body":"[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Atención\",\n  \"body\": \"Ú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 proveedor se debe enviar el siguiente JSON:\n\n```\n{\n    \"date\" : \"2016-06-27\"\n}\n```\n\nPara eliminar algún dato de la factura de proveedor enviar el atributo en null, así:\n```\n{\n    \"observations\" : null\n}\n```\n\nSe retorna la factura de proveedor que se ha modificado con los datos actualizados.","updates":[],"order":4,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5c7ea38633a210000ef9d9f1","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","5e9f0d4c720ad8006c6c7dc1","5ea9c2f382fcd2003df9f412","5ec7defc6aa2be001e7504f5","5ed8f716a8308c0412b5473a","5ed9274fe5a9b8041fd1df43","5ed92afa0d09d60253220b3f","5efcff9cd7e1be00118e8272","5f172282d7522c03be08713f","5f3c4814ac3e6209c38b7615","5f4fbe7281626c006887f104","5f5242887d2f8701ff580d22"],"_id":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a","releaseDate":"2016-01-29T20:57:39.712Z","__v":43,"createdAt":"2016-01-29T20:57:39.712Z"},"category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Facturas de Proveedor","slug":"facturas-de-proveedor","order":21,"from_sync":false,"reference":false,"_id":"5c7e9c7c412d4c003f750162","project":"56abd2434e4b730d009eb10a","version":"56abd2434e4b730d009eb10d","createdAt":"2019-03-05T15:57:48.910Z","__v":0},"user":"5a2184feb778240012e38415","createdAt":"2019-03-05T16:27:50.901Z","__v":9,"parentDoc":null}

putEditar factura de proveedor


Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

id:
required
integer
Id de la factura de proveedor que se desea editar.

Body Params

date:
yyyy-mm-dd
Fecha de la factura de proveedor. Formato yyyy-MM-dd.
dueDate:
yyyy-mm-dd
Fecha de vencimiento de la factura de proveedor. Formato yyyy-MM-dd.
observations:
string
Observaciones de la factura de proveedor (no visibles en el pdf o documento impreso). Longitud máxima permitida: 500.
termsConditions:
string
Términos y condiciones de la factura de proveedor. Longitud máxima permitida: 500.
numberTemplate:
object
Objeto que contiene la información de la numeración de la factura de proveedor. El objeto debe contener el campo `number` con el número de factura. Para la versión Dominicana se pueden incluir los campos `prefix` con el prefijo e `informalProvider` con el valor true o false
subjectToProportionality:
boolean
Para Dominicana
provider:
mixed
Objecto que contiene el id del proveedor asociado a la factura. Se puede enviar directamente el id del proveedor en este atributo.
currency:
object
Objecto que incluye la información de la moneda y tasa de cambio asociada a la factura de proveedor. 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.
warehouse:
mixed
Objeto que indica el id de la bodega/almacén asociada a la factura de proveedor. 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.
retentions:
array of objects
Array de objetos retention que indican las retenciones de la factura de proveedor. Cada objeto debe contener: `id (number, obligatorio)`: Identificador de la retención que se desea asociar a la factura; `amount (double, obligatorio)`: valor retenido.
purchases:
object
Objetos con los ítems y categorías comprados en la factura de proveedor. `items (array_object)`: Contiene los ítems asociados a la factura. Cada objeto ítem debe incluir: `id (number, obligatorio)`: identificador del ítem que se compra; `price (double, obligatorio)`: precio de compra del ítem; `discount (double)`: valor del descuento; `quantity (number, obligatorio)`: cantidad comprada del ítem; `observations (string)` : observaciones del ítem; `tax (array)` : array de objetos tax que indican la información del impuesto; Cada objeto categoría debe incluir: `id (number, obligatorio)`: identificador de la categoría que se compra; `price (double, obligatorio)`: precio de compra de la categoría; `discount (double)`: valor del descuento; `quantity (number, obligatorio)`: cantidad comprada de la categoría; `observations (string)` : observaciones de la categoría; `tax (array)` : array de objetos tax que indican la información del impuesto
costCenter:
mixed
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 proveedor no se puede editar.

Documentation

[block:callout] { "type": "warning", "title": "Atención", "body": "Ú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 proveedor se debe enviar el siguiente JSON: ``` { "date" : "2016-06-27" } ``` Para eliminar algún dato de la factura de proveedor enviar el atributo en null, así: ``` { "observations" : null } ``` Se retorna la factura de proveedor que se ha modificado con los datos actualizados.

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