{"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"}]},"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"],"_id":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a","releaseDate":"2016-01-29T20:57:39.712Z","__v":39,"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":7,"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.

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