{"_id":"5c8e6e7784bd6f00571ce06a","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":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2019-03-17T15:57:43.613Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"Una factura de proveedor contiene los siguientes atributos:\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"id\",\n    \"0-1\": \"Integer\",\n    \"0-2\": \"Identificador único que representa una factura específica. La aplicación lo asigna automáticamente.\",\n    \"0-3\": \"1\",\n    \"h-0\": \"Nombre\",\n    \"h-1\": \"Tipo\",\n    \"h-2\": \"Descripción\",\n    \"h-3\": \"Ejemplo\",\n    \"1-0\": \"date\",\n    \"1-1\": \"String.  Formato yyyy-MM-dd\",\n    \"1-2\": \"Fecha de la factura.\",\n    \"1-3\": \"2019-02-12\",\n    \"2-0\": \"dueDate\",\n    \"2-1\": \"String.  Formato yyyy-MM-dd\",\n    \"2-2\": \"Fecha de vencimiento de la factura.\",\n    \"2-3\": \"2019-02-12\",\n    \"3-0\": \"observations\",\n    \"3-1\": \"String\",\n    \"3-2\": \"Observaciones de la factura.\",\n    \"3-3\": \"Estas son las observaciones de mi factura.\",\n    \"4-0\": \"termsConditions\",\n    \"4-1\": \"String\",\n    \"4-2\": \"Términos y condiciones aplicables a la factura.\",\n    \"4-3\": \"Limite garantía de 1 año\",\n    \"6-0\": \"status\",\n    \"6-1\": \"String\",\n    \"6-2\": \"Estado de la factura, las opciones posibles son: \\n* open : La factura no se ha pagado completamente.\\n* closed: La factura se ha pagado completamente\",\n    \"6-3\": \"open\",\n    \"7-0\": \"provider\",\n    \"7-1\": \"Object\",\n    \"7-2\": \"Objeto que contiene la información del proveedor asociado a la factura.\",\n    \"7-3\": \"```\\n{\\n\\\"id\\\": 1,\\n\\\"name\\\": \\\"Coorporación Alegrate\\\",                        \\\"identification\\\": \\\"159.549.847\\\",\\n\\\"email\\\": \\\"prueba:::at:::alegra.com\\\",                      \\\"phonePrimary\\\": \\\"999-99-99\\\",\\n\\\"phoneSecondary\\\": \\\"\\\",\\n\\\"fax\\\": \\\"\\\",\\n\\\"mobile\\\": \\\"(333) 555-55-55\\\"\\n}\\n```\",\n    \"10-0\": \"numberTemplate\",\n    \"10-1\": \"Object\",\n    \"10-2\": \"Objeto que contiene la información de la numeración de la factura.  Contiene los siguientes atributos:\\n* number: Número de la factura.\",\n    \"10-3\": \"```\\n{\\n\\\"number\\\" : 520\\n}\\n```\",\n    \"12-0\": \"total\",\n    \"12-1\": \"Double\",\n    \"12-2\": \"Total de la factura. Se debe tener en cuenta que el total de la factura es calculado según la precisión decimal que tenga configurada la empresa al momento de crear la factura.\",\n    \"12-3\": \"12500.45\",\n    \"13-0\": \"totalPaid\",\n    \"13-1\": \"Double\",\n    \"13-2\": \"Total pagado a la factura.\",\n    \"13-3\": \"500.00\",\n    \"14-0\": \"balance\",\n    \"14-1\": \"Double\",\n    \"14-2\": \"Saldo pendiente por pagar a la factura.\",\n    \"14-3\": \"12000.45\",\n    \"15-0\": \"decimalPrecision\",\n    \"15-1\": \"Integer\",\n    \"15-2\": \"Precisión decimal de la factura\",\n    \"15-3\": \"2\",\n    \"16-0\": \"warehouse\",\n    \"16-1\": \"Object\",\n    \"16-2\": \"Objeto que contiene la información de la bodega de la factura.\\nContiene los siguientes atributos:\\n* id: Identificador único que representa una bodega específica.\\n* name: Nombre de la bodega.\",\n    \"16-3\": \"```\\n{\\n\\\"id\\\" : 1,\\n\\\"name\\\" : \\\"Nombre de la bodega\\\"\\n}\\n```\",\n    \"17-0\": \"purchases\",\n    \"17-1\": \"Object\",\n    \"17-2\": \"Objeto que contiene los productos y categorías de la factura.\\nContiene los siguientes atributos:\\n\\n**items**: Array de objetos Item, que contiene los productos.\\nCada objeto contiene los siguientes atributos:\\n* id: Identificador del producto. \\n* name: Nombre del producto.\\n* discount: Porcentaje de descuento aplicado al producto.\\n* observations: Observaciones del producto. \\n* tax: Array de objetos tax que indican los impuestos aplicados al producto al momento de la compra.\\n* price: Precio de compra del producto.\\n* quantity: Cantidad comprada del producto.\\n* total: Total del producto (no incluye impuestos).\\n* subtotal: Subtotal del producto.\\n\\n**categories**: Array de objetos category, que contiene las categorías.\\nCada objeto contiene los siguientes atributos:\\n* id: Identificador de la categoría. \\n* name: Nombre de la categoría.\\n* discount: Porcentaje de descuento aplicado a la categoría.\\n* observations: Observaciones de la categoría. \\n* tax: Array de objetos tax que indican los impuestos aplicados a la categoría al momento de la compra.\\n* price: Precio de compra de la categoría.\\n* quantity: Cantidad comprada de la categoría.\\n* total: Total de la categoría (no incluye impuestos).\\n* subtotal: Subtotal de la categoría.\",\n    \"17-3\": \"```\\n{\\n\\\"items\\\": [\\n{\\n\\\"id\\\": 1,\\n\\\"name\\\": \\\"Billetera\\\",\\n\\\"observations\\\": \\\"Billetera de cuero negro\\\",\\n\\\"discount\\\" : 10,\\n\\\"tax\\\" : [\\n{\\n\\\"id\\\" : 6,\\n\\\"name\\\" : \\\"IVA\\\",\\n\\\"percentage\\\" : 16,\\n\\\"description\\\" : \\\"Impuesto de valor agregado\\\",\\n\\\"type\\\": \\\"IVA\\\",\\n\\\"status\\\": \\\"active\\\"\\n}\\n],\\n\\\"price\\\" : 80,\\n\\\"quantity\\\" : 5,\\n\\\"total\\\" : 360,\\n\\\"subtotal\\\": 360\\n}\\n],\\n\\\"categories\\\": [\\n{\\n\\\"id\\\": 5091,\\n\\\"name\\\": \\\"Otros gastos\\\",\\n\\\"observations\\\": \\\"Observaciones de la categoría.\\\",\\n\\\"discount\\\" : 10,\\n\\\"tax\\\" : [\\n{\\n\\\"id\\\" : 6,\\n\\\"name\\\" : \\\"IVA\\\",\\n\\\"percentage\\\" : 16,\\n\\\"description\\\" : \\\"Impuesto de valor agregado\\\",\\n\\\"type\\\": \\\"IVA\\\",\\n\\\"status\\\": \\\"active\\\"\\n}\\n],\\n\\\"price\\\" : 80,\\n\\\"quantity\\\" : 5,\\n\\\"total\\\" : 360,\\n\\\"subtotal\\\": 360\\n}\\n]\\n}\\n```\",\n    \"18-0\": \"retentions\",\n    \"18-1\": \"Array\",\n    \"18-2\": \"Array de objetos retention que indican las retenciones aplicadas a la factura. Cada objeto contiene los siguientes atributos:\\n* id: Identificador de la retención.\\n* name : Nombre de la retención.\\n* percentage: Porcentaje retenido.\\n* amount: Valor retenido.\",\n    \"18-3\": \"```\\n[\\n{\\n\\\"id\\\": 1,\\n\\\"name\\\" : \\\"Compras\\\",\\n\\\"percentage\\\" : 3,5,\\n\\\"amount\\\" : 21.315\\n}\\n]\\n```\",\n    \"19-0\": \"currency\",\n    \"19-1\": \"Object\",\n    \"19-2\": \"Objeto que incluye la información de la moneda asociada a la factura.\\n** Solo se incluye si la compañía tiene activo multimoneda y la factura está en una moneda diferente de la principal de la compañía.\\n**\\nEste objeto contiene:\\n* code : Código ISO de la moneda asociada a la empresa.\\n* exchangeRate: Tasa de cambio.\",\n    \"19-3\": \"```\\n{\\n\\\"code\\\" : \\\"USD\\\",\\n\\\"symbol\\\" : \\\"$\\\",\\n\\\"exchangeRae\\\" : 2950\\n}\\n```\",\n    \"20-0\": \"payments\",\n    \"20-1\": \"Array\",\n    \"20-2\": \"Incluye la información de pagos realizados a la factura.\\nCada objeto contiene los siguientes atributos:\\n* id: Identificador único del pago\\n* number: Número del recibo de pago.\\n* date: Fecha del pago.\\n* amount: Valor pagado.\\n* paymentMethod: Método de pago.\\n* observations: Observaciones del pago\\n* anotation: Notas del pago\\n* status: Estado del pago.  Las opciones posibles son \\\"open\\\" para un pago activo, y \\\"void\\\" para un pago que se encuentra anulado.\",\n    \"20-3\": \"```\\n{\\nid: \\\"123\\\",\\nnumber: \\\"5000\\\",\\ndate: \\\"2019-02-12\\\",\\namount: \\\"1000\\\",\\npaymentMethod: \\\"transfer\\\",\\nobservations: \\\"\\\",\\nanotation: \\\"\\\",\\nstatus: \\\"open\\\"\\n}\\n```\",\n    \"11-0\": \"numberTemplate (República Dominicana)\",\n    \"11-1\": \"Object\",\n    \"11-2\": \"**Solo para versión Alegra República Dominicana**\\n\\nObjeto que contiene la información de la numeración de la factura.  Contiene los siguientes atributos:\\n* prefix: Prefijo de la factura.\\n* number: Número de la factura.\\n* informalProvider: Indica si es un proveedor informal.\",\n    \"11-3\": \"```\\n{\\n\\\"prefix\\\": \\\"B1\\\",\\n\\\"number\\\" : 100000001,\\n\\\"informalProvider\\\": true\\n}\\n```\",\n    \"5-0\": \"subjectToProportionality (República Dominicana)\",\n    \"5-1\": \"Boolean\",\n    \"5-2\": \"**Solo para versión Alegra República Dominicana**\\n\\nSi 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.\",\n    \"5-3\": \"true\",\n    \"8-0\": \"provider (Perú)\",\n    \"8-1\": \"Object\",\n    \"8-2\": \"**Solo para versión Alegra Perú**\\n\\nObjeto que contiene la información del proveedor asociado a la factura.\\n\\nEn Perú el atributo `identification` pasa a ser un objeto que contiene el atributo `number` con la identificación del proveedor.\",\n    \"8-3\": \"```\\n{\\n\\\"id\\\": 1,\\n\\\"name\\\": \\\"Coorporación Alegrate\\\",                        \\\"identification\\\": {\\n\\\"number\\\": \\\"159.549.847\\\"\\n},\\n\\\"email\\\": \\\"prueba@alegra.com\\\",                      \\\"phonePrimary\\\": \\\"999-99-99\\\",\\n\\\"phoneSecondary\\\": \\\"\\\",\\n\\\"fax\\\": \\\"\\\",\\n\\\"mobile\\\": \\\"(333) 555-55-55\\\"\\n}\\n```\",\n    \"9-0\": \"provider (Colombia)\",\n    \"9-1\": \"Object\",\n    \"9-2\": \"**Solo para versión Alegra Colombia**\\n\\nObjeto que contiene la información del proveedor asociado a la factura.\\n\\nEn Colombia contiene el atributo adicional `identificationObject` el cual es un objeto que consta del atributo `number` con la identificación del proveedor.\",\n    \"9-3\": \"```\\n{\\n\\\"id\\\": 1,\\n\\\"name\\\": \\\"Coorporación Alegrate\\\",                        \\n\\\"identification\\\": \\\"159.549.847\\\",\\n\\\"identificationObject\\\": {\\n\\\"number\\\": \\\"159.549.847\\\"\\n},\\n\\\"email\\\": \\\"prueba@alegra.com\\\",                      \\\"phonePrimary\\\": \\\"999-99-99\\\",\\n\\\"phoneSecondary\\\": \\\"\\\",\\n\\\"fax\\\": \\\"\\\",\\n\\\"mobile\\\": \\\"(333) 555-55-55\\\"\\n}\\n```\"\n  },\n  \"cols\": 4,\n  \"rows\": 21\n}\n[/block]","excerpt":"Endpoint /bills","slug":"facturas-de-proveedor","type":"basic","title":"Descripción general"}

Descripción general

Endpoint /bills

Una factura de proveedor contiene los siguientes atributos: [block:parameters] { "data": { "0-0": "id", "0-1": "Integer", "0-2": "Identificador único que representa una factura específica. La aplicación lo asigna automáticamente.", "0-3": "1", "h-0": "Nombre", "h-1": "Tipo", "h-2": "Descripción", "h-3": "Ejemplo", "1-0": "date", "1-1": "String. Formato yyyy-MM-dd", "1-2": "Fecha de la factura.", "1-3": "2019-02-12", "2-0": "dueDate", "2-1": "String. Formato yyyy-MM-dd", "2-2": "Fecha de vencimiento de la factura.", "2-3": "2019-02-12", "3-0": "observations", "3-1": "String", "3-2": "Observaciones de la factura.", "3-3": "Estas son las observaciones de mi factura.", "4-0": "termsConditions", "4-1": "String", "4-2": "Términos y condiciones aplicables a la factura.", "4-3": "Limite garantía de 1 año", "6-0": "status", "6-1": "String", "6-2": "Estado de la factura, las opciones posibles son: \n* open : La factura no se ha pagado completamente.\n* closed: La factura se ha pagado completamente", "6-3": "open", "7-0": "provider", "7-1": "Object", "7-2": "Objeto que contiene la información del proveedor asociado a la factura.", "7-3": "```\n{\n\"id\": 1,\n\"name\": \"Coorporación Alegrate\", \"identification\": \"159.549.847\",\n\"email\": \"prueba@alegra.com\", \"phonePrimary\": \"999-99-99\",\n\"phoneSecondary\": \"\",\n\"fax\": \"\",\n\"mobile\": \"(333) 555-55-55\"\n}\n```", "10-0": "numberTemplate", "10-1": "Object", "10-2": "Objeto que contiene la información de la numeración de la factura. Contiene los siguientes atributos:\n* number: Número de la factura.", "10-3": "```\n{\n\"number\" : 520\n}\n```", "12-0": "total", "12-1": "Double", "12-2": "Total de la factura. Se debe tener en cuenta que el total de la factura es calculado según la precisión decimal que tenga configurada la empresa al momento de crear la factura.", "12-3": "12500.45", "13-0": "totalPaid", "13-1": "Double", "13-2": "Total pagado a la factura.", "13-3": "500.00", "14-0": "balance", "14-1": "Double", "14-2": "Saldo pendiente por pagar a la factura.", "14-3": "12000.45", "15-0": "decimalPrecision", "15-1": "Integer", "15-2": "Precisión decimal de la factura", "15-3": "2", "16-0": "warehouse", "16-1": "Object", "16-2": "Objeto que contiene la información de la bodega de la factura.\nContiene los siguientes atributos:\n* id: Identificador único que representa una bodega específica.\n* name: Nombre de la bodega.", "16-3": "```\n{\n\"id\" : 1,\n\"name\" : \"Nombre de la bodega\"\n}\n```", "17-0": "purchases", "17-1": "Object", "17-2": "Objeto que contiene los productos y categorías de la factura.\nContiene los siguientes atributos:\n\n**items**: Array de objetos Item, que contiene los productos.\nCada objeto contiene los siguientes atributos:\n* id: Identificador del producto. \n* name: Nombre del producto.\n* discount: Porcentaje de descuento aplicado al producto.\n* observations: Observaciones del producto. \n* tax: Array de objetos tax que indican los impuestos aplicados al producto al momento de la compra.\n* price: Precio de compra del producto.\n* quantity: Cantidad comprada del producto.\n* total: Total del producto (no incluye impuestos).\n* subtotal: Subtotal del producto.\n\n**categories**: Array de objetos category, que contiene las categorías.\nCada objeto contiene los siguientes atributos:\n* id: Identificador de la categoría. \n* name: Nombre de la categoría.\n* discount: Porcentaje de descuento aplicado a la categoría.\n* observations: Observaciones de la categoría. \n* tax: Array de objetos tax que indican los impuestos aplicados a la categoría al momento de la compra.\n* price: Precio de compra de la categoría.\n* quantity: Cantidad comprada de la categoría.\n* total: Total de la categoría (no incluye impuestos).\n* subtotal: Subtotal de la categoría.", "17-3": "```\n{\n\"items\": [\n{\n\"id\": 1,\n\"name\": \"Billetera\",\n\"observations\": \"Billetera de cuero negro\",\n\"discount\" : 10,\n\"tax\" : [\n{\n\"id\" : 6,\n\"name\" : \"IVA\",\n\"percentage\" : 16,\n\"description\" : \"Impuesto de valor agregado\",\n\"type\": \"IVA\",\n\"status\": \"active\"\n}\n],\n\"price\" : 80,\n\"quantity\" : 5,\n\"total\" : 360,\n\"subtotal\": 360\n}\n],\n\"categories\": [\n{\n\"id\": 5091,\n\"name\": \"Otros gastos\",\n\"observations\": \"Observaciones de la categoría.\",\n\"discount\" : 10,\n\"tax\" : [\n{\n\"id\" : 6,\n\"name\" : \"IVA\",\n\"percentage\" : 16,\n\"description\" : \"Impuesto de valor agregado\",\n\"type\": \"IVA\",\n\"status\": \"active\"\n}\n],\n\"price\" : 80,\n\"quantity\" : 5,\n\"total\" : 360,\n\"subtotal\": 360\n}\n]\n}\n```", "18-0": "retentions", "18-1": "Array", "18-2": "Array de objetos retention que indican las retenciones aplicadas a la factura. Cada objeto contiene los siguientes atributos:\n* id: Identificador de la retención.\n* name : Nombre de la retención.\n* percentage: Porcentaje retenido.\n* amount: Valor retenido.", "18-3": "```\n[\n{\n\"id\": 1,\n\"name\" : \"Compras\",\n\"percentage\" : 3,5,\n\"amount\" : 21.315\n}\n]\n```", "19-0": "currency", "19-1": "Object", "19-2": "Objeto que incluye la información de la moneda asociada a la factura.\n** Solo se incluye si la compañía tiene activo multimoneda y la factura está en una moneda diferente de la principal de la compañía.\n**\nEste objeto contiene:\n* code : Código ISO de la moneda asociada a la empresa.\n* exchangeRate: Tasa de cambio.", "19-3": "```\n{\n\"code\" : \"USD\",\n\"symbol\" : \"$\",\n\"exchangeRae\" : 2950\n}\n```", "20-0": "payments", "20-1": "Array", "20-2": "Incluye la información de pagos realizados a la factura.\nCada objeto contiene los siguientes atributos:\n* id: Identificador único del pago\n* number: Número del recibo de pago.\n* date: Fecha del pago.\n* amount: Valor pagado.\n* paymentMethod: Método de pago.\n* observations: Observaciones del pago\n* anotation: Notas del pago\n* status: Estado del pago. Las opciones posibles son \"open\" para un pago activo, y \"void\" para un pago que se encuentra anulado.", "20-3": "```\n{\nid: \"123\",\nnumber: \"5000\",\ndate: \"2019-02-12\",\namount: \"1000\",\npaymentMethod: \"transfer\",\nobservations: \"\",\nanotation: \"\",\nstatus: \"open\"\n}\n```", "11-0": "numberTemplate (República Dominicana)", "11-1": "Object", "11-2": "**Solo para versión Alegra República Dominicana**\n\nObjeto que contiene la información de la numeración de la factura. Contiene los siguientes atributos:\n* prefix: Prefijo de la factura.\n* number: Número de la factura.\n* informalProvider: Indica si es un proveedor informal.", "11-3": "```\n{\n\"prefix\": \"B1\",\n\"number\" : 100000001,\n\"informalProvider\": true\n}\n```", "5-0": "subjectToProportionality (República Dominicana)", "5-1": "Boolean", "5-2": "**Solo para versión Alegra República Dominicana**\n\nSi 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.", "5-3": "true", "8-0": "provider (Perú)", "8-1": "Object", "8-2": "**Solo para versión Alegra Perú**\n\nObjeto que contiene la información del proveedor asociado a la factura.\n\nEn Perú el atributo `identification` pasa a ser un objeto que contiene el atributo `number` con la identificación del proveedor.", "8-3": "```\n{\n\"id\": 1,\n\"name\": \"Coorporación Alegrate\", \"identification\": {\n\"number\": \"159.549.847\"\n},\n\"email\": \"prueba@alegra.com\", \"phonePrimary\": \"999-99-99\",\n\"phoneSecondary\": \"\",\n\"fax\": \"\",\n\"mobile\": \"(333) 555-55-55\"\n}\n```", "9-0": "provider (Colombia)", "9-1": "Object", "9-2": "**Solo para versión Alegra Colombia**\n\nObjeto que contiene la información del proveedor asociado a la factura.\n\nEn Colombia contiene el atributo adicional `identificationObject` el cual es un objeto que consta del atributo `number` con la identificación del proveedor.", "9-3": "```\n{\n\"id\": 1,\n\"name\": \"Coorporación Alegrate\", \n\"identification\": \"159.549.847\",\n\"identificationObject\": {\n\"number\": \"159.549.847\"\n},\n\"email\": \"prueba@alegra.com\", \"phonePrimary\": \"999-99-99\",\n\"phoneSecondary\": \"\",\n\"fax\": \"\",\n\"mobile\": \"(333) 555-55-55\"\n}\n```" }, "cols": 4, "rows": 21 } [/block]