{"_id":"5c8e9ac6d571760037edaff0","project":"56abd2434e4b730d009eb10a","version":{"_id":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a","__v":27,"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"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1"},"category":{"_id":"5c7e9c7c412d4c003f750162","project":"56abd2434e4b730d009eb10a","version":"56abd2434e4b730d009eb10d","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2019-03-05T15:57:48.910Z","from_sync":false,"order":20,"slug":"facturas-de-proveedor","title":"Facturas de Proveedor"},"user":"56abd213d4432d1900eed227","__v":3,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2019-03-17T19:06:46.226Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"method":"post","examples":{"codes":[{"code":"{\n    \"date\": \"2019-02-12\",\n    \"dueDate\": \"2019-02-12\",\n    \"provider\": 1,\n    \"purchases\": {\n        \"categories\": [\n            {\n                \"id\": 5091,\n                \"price\": 120,\n                \"quantity\": 5,\n                \"discount\": 10,\n                \"observations\": \"Otros gastos\",\n                \"tax\": [\n                    {\n                        \"id\": 1\n                    }\n                ]\n            }\n        ],\n        \"items\": [\n            {\n                \"id\": 1,\n                \"price\": 120,\n                \"quantity\": 5,\n                \"discount\": 10,\n                \"observations\": \"Artículos de escritorio y papelería\",\n                \"tax\": [\n                    {\n                        \"id\": 1\n                    }\n                ]\n            }\n        ]\n    }\n}","language":"json","name":"Factura sencilla"},{"code":"{\n    \"date\": \"2019-02-12\",\n    \"dueDate\": \"2019-02-12\",\n    \"observations\": \"Se adquirieron suplementos de oficina\",\n    \"termsConditions\": \"Términos y condiciones de mi empresa\",\n    \"numberTemplate\": {\n        \"number\": \"FP0001\"\n    },\n    \"provider\": {\n        \"id\": 1\n    },\n    \"warehouse\": {\n        \"id\": 2\n    },\n    \"currency\": {\n        \"code\": \"USD\",\n        \"exchangeRate\": 3136\n    },\n    \"purchases\": {\n        \"categories\": [\n            {\n                \"id\": 5091,\n                \"price\": 120,\n                \"quantity\": 5,\n                \"discount\": 10,\n                \"observations\": \"Otros gastos\",\n                \"tax\": [\n                    {\n                        \"id\": 1\n                    }\n                ]\n            }\n        ],\n        \"items\": [\n            {\n                \"id\": 1,\n                \"price\": 120,\n                \"quantity\": 5,\n                \"discount\": 10,\n                \"observations\": \"Artículos de escritorio y papelería\",\n                \"tax\": [\n                    {\n                        \"id\": 1\n                    }\n                ]\n            }\n        ]\n    },\n    \"retentions\": [\n        {\n            \"id\": 1,\n            \"amount\": 10\n        }\n    ],\n    \"payments\": [\n        {\n            \"date\": \"2019-02-12\",\n            \"account\": {\n                \"id\": 1\n            },\n            \"amount\": 100,\n            \"paymentMethod\": \"cash\",\n            \"anotations\": \"Se pagó parte de la factura\",\n            \"observations\": \"El pago se realizó en efectivo\",\n            \"currency\": {\n                \"code\": \"USD\",\n                \"exchangeRate\": 3136\n            },\n            \"retentions\": [\n                {\n                    \"id\": 1,\n                    \"amount\": 50\n                }\n            ]\n        }\n    ]\n}","language":"json","name":"Factura completa"},{"code":"curl -v -H \"Accept: application/json\" -H \"Content-type: application/json\" -X POST  https://app.alegra.com/api/v1/bills/ -u 'micorreo:::at:::alegra.com:mitoken12345' -d '{\"date\": \"2019-02-12\", \"dueDate\": \"2019-02-12\", \"client\":  1, \"purchases\" : { \"categories\" : [ { \"id\": 5091, \"price\" : 120, \"quantity\" : 5, \"discount\" : 10, \"observations\": \"Otros gastos\", \"tax\" : [ { \"id\" : 1 } ] }], \"items\" : [ { \"id\": 1, \"price\" : 120, \"quantity\" : 5, \"discount\" : 10, \"observations\": \"Artículos de escritorio y papelería\", \"tax\" : [ { \"id\" : 1 } ] }] }}'","language":"curl"},{"code":"{\n    \"date\": \"2019-02-12\",\n    \"dueDate\": \"2019-02-12\",\n    \"subjectToProportionality\": true,\n    \"numberTemplate\": {\n        \"informalProvider\": true\n    },\n    \"provider\": 1,\n    \"purchases\": {\n        \"categories\": [\n            {\n                \"id\": 5091,\n                \"price\": 120,\n                \"quantity\": 5,\n                \"discount\": 10,\n                \"observations\": \"Otros gastos\",\n                \"tax\": [\n                    {\n                        \"id\": 1\n                    }\n                ]\n            }\n        ],\n        \"items\": [\n            {\n                \"id\": 1,\n                \"price\": 120,\n                \"quantity\": 5,\n                \"discount\": 10,\n                \"observations\": \"Artículos de escritorio y papelería\",\n                \"tax\": [\n                    {\n                        \"id\": 1\n                    }\n                ]\n            }\n        ]\n    }\n}","language":"json","name":"Factura sencilla República Dominicana"}]},"results":{"codes":[{"name":"","code":"{\n    \"id\": \"2\",\n    \"date\": \"2019-02-12\",\n    \"dueDate\": \"2019-02-12\",\n    \"observations\": \"Se adquirieron suplementos de oficina\",\n    \"termsConditions\": \"Términos y condiciones de mi empresa\",\n    \"status\": \"open\",\n    \"provider\": {\n        \"id\": \"1\",\n        \"name\": \"Papelería Alegría S.A.S\",\n        \"identification\": \"1234567890\",\n        \"phonePrimary\": \"\",\n        \"phoneSecondary\": \"\",\n        \"fax\": \"\",\n        \"mobile\": \"\",\n        \"email\": \"\",\n        \"identificationObject\": {\n            \"number\": \"1234567890\"\n        }\n    },\n    \"numberTemplate\": {\n        \"number\": \"FP0001\"\n    },\n    \"total\": 1134,\n    \"totalPaid\": 0,\n    \"balance\": 1074,\n    \"decimalPrecision\": \"0\",\n    \"warehouse\": {\n        \"id\": \"2\",\n        \"name\": \"Almacén de la 80\"\n    },\n    \"payments\": [\n        {\n            \"id\": \"10\",\n            \"prefix\": null,\n            \"number\": \"4\",\n            \"date\": \"2019-02-12\",\n            \"amount\": 100,\n            \"paymentMethod\": \"cash\",\n            \"observations\": \"El pago se realizó en efectivo\",\n            \"anotation\": \"Se pagó parte de la factura\",\n            \"status\": \"open\"\n        }\n    ],\n    \"purchases\": {\n        \"items\": [\n            {\n                \"id\": \"3\",\n                \"name\": \"Artículos de escritorio y papelería\",\n                \"price\": 120,\n                \"discount\": 10,\n                \"observations\": \"Artículos de escritorio y papelería\",\n                \"tax\": [\n                    {\n                        \"id\": \"2\",\n                        \"name\": \"IVA\",\n                        \"percentage\": \"5.00\",\n                        \"description\": \"\",\n                        \"status\": \"active\",\n                        \"type\": \"IVA\",\n                        \"amount\": 27\n                    }\n                ],\n                \"quantity\": 5,\n                \"taxAmount\": 27,\n                \"subtotal\": 540,\n                \"total\": 567\n            }\n        ],\n        \"categories\": [\n            {\n                \"id\": \"5066\",\n                \"name\": \"Papelería\",\n                \"price\": 120,\n                \"discount\": 10,\n                \"observations\": \"Papelería\",\n                \"tax\": [\n                    {\n                        \"id\": \"2\",\n                        \"name\": \"IVA\",\n                        \"percentage\": \"5.00\",\n                        \"description\": \"\",\n                        \"status\": \"active\",\n                        \"type\": \"IVA\",\n                        \"amount\": 27\n                    }\n                ],\n                \"quantity\": 5,\n                \"taxAmount\": 27,\n                \"subtotal\": 540,\n                \"total\": 567\n            }\n        ]\n    },\n    \"retentions\": [\n        {\n            \"id\": \"1\",\n            \"name\": \"Arrendamiento de bienes muebles\",\n            \"percentage\": \"4.0000\",\n            \"amount\": 10\n        },\n        {\n            \"id\": \"1\",\n            \"name\": \"Arrendamiento de bienes muebles\",\n            \"percentage\": \"4.0000\",\n            \"amount\": 50\n        }\n    ]\n}","language":"json","status":200},{"name":"","code":"{ \n    \"error\": \"La información para crear el modelo no existe o es inválida\",\n    \"code\" : 400\n}","language":"json","status":400}]},"settings":"","auth":"required","params":[{"_id":"5c8e9ac6d571760037edaffe","ref":"","in":"body","required":true,"desc":"Fecha de la factura. Formato yyyy-MM-dd.","default":"","type":"yyyy-mm-dd","name":"date"},{"_id":"5c8e9ac6d571760037edaffd","ref":"","in":"body","required":true,"desc":"Fecha de vencimiento de la factura. Formato yyyy-MM-dd.","default":"","type":"yyyy-mm-dd","name":"dueDate"},{"_id":"5c8e9ac6d571760037edaffc","ref":"","in":"body","required":false,"desc":"Observaciones de la factura. Longitud máxima permitida: 500.","default":"","type":"string","name":"observations"},{"_id":"5c8e9ac6d571760037edaffb","ref":"","in":"body","required":false,"desc":"Términos y condiciones de la factura. Longitud máxima permitida: 500.","default":"","type":"string","name":"termsConditions"},{"_id":"5c8e9ac6d571760037edaffa","ref":"","in":"body","required":false,"desc":"Objeto que contiene la información de la numeración de la factura. Se puede especificar el número de la factura en él a través del atributo `number`. En República Dominicana si se especifica el atributo `informalProvider` en `true` la factura se crea con la numeración automática *Numeración proveedores informales (11)* registrada por defecto en dicho país.","default":"","type":"mixed","name":"numberTemplate"},{"_id":"5c8e9ac6d571760037edaff9","ref":"","in":"body","required":false,"desc":"Para República Dominicana, si está presente y es `true` indica si es una operación sujeta a proporcionalidad. Si está activa se considera el ITBIS en la proporcionalidad de los reportes.","default":"false","type":"boolean","name":"subjectToProportionality"},{"_id":"5c8e9ac6d571760037edaff8","ref":"","in":"body","required":true,"desc":"Objeto que contiene el id del proveedor asociado a la factura. Se puede enviar directamente el id del proveedor en este atributo.","default":"","type":"mixed","name":"provider"},{"_id":"5c8e9ac6d571760037edaff7","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":"5c8e9ac6d571760037edaff6","ref":"","in":"body","required":false,"desc":"Objeto 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":"5c8e9ac6d571760037edaff5","ref":"","in":"body","required":true,"desc":"Objeto que contiene los arreglos `items` y `categories` con la información de los items inventariables y categorías de egresos y/o activos fijos para la factura. Arreglo `items`: Array de objetos item (productos inventariables) asociados a la factura. Cada objeto debe incluir: `id (number, obligatorio)`: identificador del producto inventariable que se compra; `price (double, obligatorio)`: precio de compra; `observations (string)`: observaciones del producto inventariable; `tax (objeto)` : array de objetos tax que indican la información del impuesto; `quantity (obligatorio)`: cantidad comprada del producto inventariable; `discount (decimal)`: porcentaje de descuento aplicado al producto inventariable, éste no debe incluir el símbolo %. El precio del producto inventariable no debe incluir impuestos ni descuentos. Arreglo `categories`: Array de objetos category (categorías de egresos y/o activos fijos) asociados a la factura. Cada objeto debe incluir: `id (number, obligatorio)`: identificador de la categoría que se compra; `price (double, obligatorio)`: precio de compra; `observations (string)`: observaciones de la categoría; `tax (objeto)` : array de objetos tax que indican la información del impuesto; `quantity (obligatorio)`: cantidad comprada de la categoría; `discount (decimal)`: porcentaje de descuento aplicado a la categoría, éste no debe incluir el símbolo %. El precio de la categoría no debe incluir impuestos ni descuentos.","default":"","type":"object","name":"purchases"},{"_id":"5c8e9ac6d571760037edaff2","ref":"","in":"body","required":false,"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.","default":"","type":"array_object","name":"retentions"},{"_id":"5c8e9ac6d571760037edaff1","ref":"","in":"body","required":false,"desc":"Array de objetos que indican los pagos que se han realizado a la factura. Cada objeto debe contener los siguientes atributos: `date (string, obligatorio)`: fecha del pago. Formato yyyy-mm-dd; `account (object, obligatorio)`: objeto que incluye el id de la cuenta banco de donde debe salir el dinero; `amount (number, obligatorio)`: valor pagado.; `paymentMethod (string)`: método de pago, las opciones posibles son: transfer, cash, deposit, check, credit-card, debit-card; `anotations (string)`: notas del pago; `observations (string)`: observaciones del pago; `retentions (array)`: array de objetos que indican las retenciones a la factura que se realizaron en el pago; `currency (object)`: objeto que incluye la información de la moneda y la tasa de cambio asociada al pago.","default":"","type":"array_object","name":"payments"}],"url":"/bills"},"isReference":false,"order":3,"body":"","excerpt":"","slug":"crear-factura-de-proveedor","type":"endpoint","title":"Crear factura de proveedor"}

postCrear factura de proveedor


Definition

{{ api_url }}{{ page_api_url }}

Parameters

Body Params

date:
required
yyyy-mm-dd
Fecha de la factura. Formato yyyy-MM-dd.
dueDate:
required
yyyy-mm-dd
Fecha de vencimiento de la factura. Formato yyyy-MM-dd.
observations:
string
Observaciones de la factura. Longitud máxima permitida: 500.
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. Se puede especificar el número de la factura en él a través del atributo `number`. En República Dominicana si se especifica el atributo `informalProvider` en `true` la factura se crea con la numeración automática *Numeración proveedores informales (11)* registrada por defecto en dicho país.
subjectToProportionality:
booleanfalse
Para República Dominicana, si está presente y es `true` indica si es una operación sujeta a proporcionalidad. Si está activa se considera el ITBIS en la proporcionalidad de los reportes.
provider:
required
mixed
Objeto que contiene el id del proveedor asociado a la factura. Se puede enviar directamente el id del proveedor en este atributo.
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.
currency:
object
Objeto 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.
purchases:
required
object
Objeto que contiene los arreglos `items` y `categories` con la información de los items inventariables y categorías de egresos y/o activos fijos para la factura. Arreglo `items`: Array de objetos item (productos inventariables) asociados a la factura. Cada objeto debe incluir: `id (number, obligatorio)`: identificador del producto inventariable que se compra; `price (double, obligatorio)`: precio de compra; `observations (string)`: observaciones del producto inventariable; `tax (objeto)` : array de objetos tax que indican la información del impuesto; `quantity (obligatorio)`: cantidad comprada del producto inventariable; `discount (decimal)`: porcentaje de descuento aplicado al producto inventariable, éste no debe incluir el símbolo %. El precio del producto inventariable no debe incluir impuestos ni descuentos. Arreglo `categories`: Array de objetos category (categorías de egresos y/o activos fijos) asociados a la factura. Cada objeto debe incluir: `id (number, obligatorio)`: identificador de la categoría que se compra; `price (double, obligatorio)`: precio de compra; `observations (string)`: observaciones de la categoría; `tax (objeto)` : array de objetos tax que indican la información del impuesto; `quantity (obligatorio)`: cantidad comprada de la categoría; `discount (decimal)`: porcentaje de descuento aplicado a la categoría, éste no debe incluir el símbolo %. El precio de la categoría no debe incluir impuestos ni descuentos.
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.
payments:
array of objects
Array de objetos que indican los pagos que se han realizado a la factura. Cada objeto debe contener los siguientes atributos: `date (string, obligatorio)`: fecha del pago. Formato yyyy-mm-dd; `account (object, obligatorio)`: objeto que incluye el id de la cuenta banco de donde debe salir el dinero; `amount (number, obligatorio)`: valor pagado.; `paymentMethod (string)`: método de pago, las opciones posibles son: transfer, cash, deposit, check, credit-card, debit-card; `anotations (string)`: notas del pago; `observations (string)`: observaciones del pago; `retentions (array)`: array de objetos que indican las retenciones a la factura que se realizaron en el pago; `currency (object)`: objeto que incluye la información de la moneda y la tasa de cambio asociada al pago.

Examples


Result Format


User Information

Try It Out

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