{"_id":"56b20eb17ae4550d0006291e","editedParams":true,"category":{"_id":"56b4b32deed075230097d689","__v":0,"project":"56abd2434e4b730d009eb10a","version":"56abd2434e4b730d009eb10d","pages":[],"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2016-02-05T14:35:25.879Z","from_sync":false,"order":3,"slug":"facturas-de-venta","title":"Facturas de venta"},"parentDoc":null,"__v":6,"editedParams2":true,"user":"56abd213d4432d1900eed227","version":{"_id":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a","__v":20,"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"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1"},"project":"56abd2434e4b730d009eb10a","updates":["59e4b7005dd919002677a0ac"],"next":{"pages":[],"description":""},"createdAt":"2016-02-03T14:29:05.166Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"method":"post","results":{"codes":[{"status":200,"name":"","code":"{\n  \"id\": 2,\n  \"date\": \"2015-11-15\",\n  \"dueDate\": \"2015-12-15\",\n  \"observations\": \"Observaciones de la factura.\",\n  \"anotation\": \"Nota : Favor consignar a la cuenta XXXXXX\",\n  \"termsConditions\": \"Términos y condiciones de mi empresa\",\n  \"status\": \"draft\",\n  \"client\": {\n    \"id\": 2,\n    \"name\": \"Acrecer\",\n    \"identification\": \"963.654.988\",\n    \"email\": \"prueba2:::at:::alegra.com\",\n    \"phonePrimary\": \"111 11 11\",\n    \"phoneSecondary\": \"\",\n    \"fax\": \"\",\n    \"mobile\": \"(333) 555-55-55\",\n    \"observations\": \"\",\n    \"address\": {\n      \"address\": \"Avenida Madison\",\n      \"city\": \"New York, USA\"\n      }\n  },\n  \"numberTemplate\": [\n    {\n      \"id\": 1,\n      \"prefix\": \"A-\",\n      \"number\": 525,\n      \"text\": \"Resolución de la DIAN # 45112\"\n      }\n  ],\n  \"retentions\": [\n    {\n      \"id\": 1,\n      \"name\": \"Compras\",\n      \"percentage\": 3.5,\n      \"amount\": 22.12\n      },\n    {\n      \"id\": 6,\n      \"name\": \"Honorarios\",\n      \"percentage\": 11,\n      \"amount\": 500\n      }\n    ],\n  \"currency\" : {\n    \"code\" : \"USD\" ,\n    \"symbol\" : \"$\",\n    \"exchangeRate\" : 3100\n    },\n  \"seller\": {\n    \"id\": \"52\",\n    \"name\": \"Carmen López\",\n    \"identification\": \"\",\n    \"observations\": \"\"\n    },\n  \"priceList\": {},\n  \"total\": 632,\n  \"totalPaid\": 500,\n  \"balance\": 132,\n  \"decimalPrecision\": 2,\n  \"items\": [\n    {\n      \"id\": 1,\n      \"name\": \"Billetera\",\n      \"description\": \"Billetera de cuero negro\",\n      \"reference\": \"REF-005\",\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\": 85,\n      \"quantity\": 5\n      },\n    {\n      \"id\": 2,\n      \"name\": \"Cartera\",\n      \"description\": \"Cartera de cuero color café\",\n      \"reference\": \"CAR-195\",\n      \"price\": 120,\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      \"quantity\": 1\n      }\n  ]\n}","language":"json"},{"language":"json","status":400,"name":"","code":"{ \n\t\"error\": \"La información para crear el modelo no existe o es inválida\",\n  \"code\" : 400\n}"},{"code":"{\n  \"error\": {\n    \"message\": \"La factura de venta no se pudo timbrar porque  la fecha de generación tiene más de 72 horas de diferencia de la fecha actual\",\n    \"code\": 3051\n  },\n  \"invoice\": {\n    \"id\": \"22\",\n    \"date\": \"2016-03-15\",\n    \"dueDate\": \"2016-03-15\",\n    \"observations\": \"\",\n    \"anotation\": \"\",\n    \"termsConditions\": \"Términos de mi factura\",\n    \"status\": \"draft\",\n    \"client\": {\n      \"id\": \"13\",\n      \"name\": \"Alejandro Mejía\",\n      \"identification\": \"XAXX010101000\",\n      \"phonePrimary\": \"111 11 11\",\n      \"phoneSecondary\": \"\",\n      \"fax\": \"\",\n      \"mobile\": \"(333) 555-55-55\",\n      \"email\": \"prueba2@alegra.com\",\n      \"address\": {\n        \"street\": \"Avenida Primero de Mayo\",\n        \"exteriorNumber\": \"95\",\n        \"interiorNumber\": \"1B\",\n        \"colony\": \"Benito Juaréz\",\n        \"locality\": null,\n        \"municipality\": null,\n        \"zipCode\": \"12345\",\n        \"state\": \"D.F\",\n        \"country\": \"México\"\n      }\n    },\n    \"numberTemplate\": {\n      \"id\": \"1\",\n      \"prefix\": null,\n      \"number\": \"22\",\n      \"text\": null\n    },\n    \"total\": 2075.24,\n    \"totalPaid\": 0,\n    \"seller\": null,\n    \"priceList\": null,\n    \"items\": [\n      {\n        \"id\": 5,\n        \"name\": \"Billetera\",\n        \"description\": \"\",\n        \"price\": 1389,\n        \"discount\": \"0.00\",\n        \"reference\": \"REF178\",\n        \"quantity\": \"1.00\",\n        \"tax\": [\n          {\n            \"id\": \"2\",\n            \"name\": \"IVA\",\n            \"percentage\": \"16.00\",\n            \"description\": \"\",\n            \"type\": \"IVA\",\n            \"status\" : \"active\"\n          }\n        ],\n        \"total\": 1611.24\n      },\n      {\n        \"id\": 1,\n        \"name\": \"Cartera\",\n        \"description\": \"\",\n        \"price\": 464,\n        \"discount\": \"0.00\",\n        \"reference\": \"REF175\",\n        \"quantity\": \"1.00\",\n        \"tax\": [],\n        \"total\": 464\n      }\n    ]\n  }\n}","language":"json","status":400,"name":"México -Proceso timbre no exitoso"},{"code":"{\n  \"error\": {\n    \"message\": \"La factura de venta no se pudo emitir porque  la numeración no es electrónica\",\n    \"code\": 3051\n  },\n  \"invoice\": {\n    \"id\": \"22\",\n    \"date\": \"2016-03-15\",\n    \"dueDate\": \"2016-03-15\",\n    \"observations\": \"\",\n    \"anotation\": \"\",\n    \"termsConditions\": \"Términos de mi factura\",\n    \"status\": \"draft\",\n    \"client\": {\n      \"id\": \"13\",\n      \"name\": \"Alejandro Mejía\",\n      \"identification\": {\n        \"type\": \"RUC\",\n        \"number\": 12345678911\n      },\n      \"phonePrimary\": \"111 11 11\",\n      \"phoneSecondary\": \"\",\n      \"fax\": \"\",\n      \"mobile\": \"(333) 555-55-55\",\n      \"email\": \"prueba2@alegra.com\",\n      \"address\": {\n        \"address\": \"AV SAN MARTIN 101\"\n      }\n    },\n    \"numberTemplate\": {\n      \"id\": \"1\",\n      \"prefix\": \"F001\",\n      \"number\": \"22\",\n      \"text\": null\n    },\n    \"total\": 2075.24,\n    \"totalPaid\": 0,\n    \"seller\": null,\n    \"priceList\": null,\n    \"items\": [\n      {\n        \"id\": 5,\n        \"name\": \"Billetera\",\n        \"description\": \"\",\n        \"price\": 1389,\n        \"discount\": \"0.00\",\n        \"reference\": \"REF178\",\n        \"description\": \"Billetera cafe\",\n        \"inventory\": {\n          \"unit\": \"unit\"\n        },\n        \"quantity\": \"1.00\",\n        \"total\": 1389\n      }\n    ]\n  }\n}","language":"json","status":400,"name":"Perú - Proceso de emisión no exitoso"}]},"settings":"","examples":{"codes":[{"name":"Factura sencilla","language":"json","code":"{\n  \"date\": \"2015-11-15\",\n  \"dueDate\": \"2015-12-15\",\n  \"client\":  2,\n  \"items\" : [\n    {\n      \"id\": 1,\n      \"price\" : 120,\n      \"quantity\" : 5\n      },\n    {\n      \"id\": 2,\n      \"description\": \"Cartera de cuero color café\",\n      \"price\": 85,\n      \"discount\" : 10,\n      \"tax\" : [\n        {\n          \"id\" : 6,\n          }\n        ],\n      \"quantity\" : 1\n      }\n    ]\n}"},{"name":"Factura completa","language":"json","code":"{\n  \"date\": \"2015-11-15\",\n  \"dueDate\": \"2015-12-15\",\n  \"observations\": \"Observaciones de la factura.\",\n  \"anotation\" : \"Nota : Favor consignar a la cuenta XXXXXX\",\n  \"termsConditions\" : \"Términos y condiciones de mi empresa\",\n  \"status\" : \"draft\",\n  \"client\": {\n    \"id\": 2\n    },\n  \"numberTemplate\" : {\n    \"id\" : 1,\n    \"prefix\" : \"A-\",\n    \"number\" : 525,\n    },\n  \"seller\" : {\n    \"id\" : \"52\"\n    },\n  \"currency\" : {\n    \"code\" : \"USD\" ,\n    \"exchangeRate\" : 3100\n  },\n  \"items\" : [\n    {\n      \"id\": 1,\n      \"description\": \"Billetera de cuero negro\",\n      \"reference\": \"REF-005\",\n      \"discount\" : 0,\n      \"tax\" : [\n        {\n          \"id\" : 6,\n          }\n        ],\n      \"price\" : 120,\n      \"quantity\" : 5\n      },\n    {\n      \"id\": 2,\n      \"description\": \"Cartera de cuero color café\",\n      \"reference\": \"CAR-195\",\n      \"price\": 85,\n      \"discount\" : 10,\n      \"tax\" : [\n        {\n          \"id\" : 6,\n          }\n        ],\n      \"quantity\" : 1\n      }\n    ],\n  \"payments\" : [\n    {\n      \"date\": \"2015-11-20\",\n      \"account\": {\n        \"id\": 2\n        },\n      \"amount\" : 100,\n      \"paymentMethod\" : \"cash\",\n      \"retentions\" : [\n        {\n          \"id\": 1,\n          \"amount\" : 50\n          }\n        ],\n      \"currency\" : {\n        \"code\": \"USD\",\n        \"exchangeRate\" : 3250\n        }\n      }\n  ]\n}"},{"code":"curl -v -H \"Accept: application/json\" -H \"Content-type: application/json\" -X POST  https://app.alegra.com/api/v1/invoices/ -u 'micorreo@alegra.com:mitoken12345' -d '{\"date\": \"2015-11-15\", \"dueDate\": \"2015-12-15\", \"client\":  2, \"items\" : [ { \"id\": 1, \"price\" : 120, \"quantity\" : 5 }, { \"id\": 2, \"description\": \"Cartera de cuero color café\", \"price\": 85, \"discount\" : 10, \"quantity\" : 1, \"tax\" : [{\"id\":6} ]}]}'","language":"curl"},{"name":"Factura Mexico para timbrar en la aplicación","code":"{\n  \"date\": \"2016-02-3\", \n  \"dueDate\": \"2016-02-15\", \n  \"client\":  2, \n  \"items\" : [ \n    { \n      \"id\": 1, \n      \"price\" : 120,\n      \"quantity\" : 5 \n    }, \n    { \n      \"id\": 3, \n      \"description\": \"Cartera de cuero color café\", \n      \"price\": 85,\n      \"discount\" : 10, \n      \"quantity\" : 1, \n      \"tax\" : [\n        { \n          \"id\" : 2 \n        }\n      ]\n    }\n  ],\n  \"accountNumber\" : 1234, \n  \"paymentMethod\": \"cash\", \n  \"stamp\": {\n    \"generateStamp\": true\n  }\n}","language":"json"},{"code":"{\n  \"date\": \"2016-02-3\", \n  \"dueDate\": \"2016-02-15\", \n  \"client\":  2, \n  \"items\" : [ \n    { \n      \"id\": 1, \n      \"price\" : 120,\n      \"quantity\" : 5 ,\n      \"description\": \"Camiseta talla S última colección\", \n    }, \n    { \n      \"id\": 3, \n      \"description\": \"Cartera de cuero color café\", \n      \"price\": 85,\n      \"discount\" : 10, \n      \"quantity\" : 1, \n      \"tax\" : [\n        { \n          \"id\" : 2 \n        }\n      ]\n    }\n  ],\n  \"stamp\": {\n    \"generateStamp\": true\n  }\n}","language":"json","name":"Factura sencilla para emitir en la aplicación"}]},"auth":"required","params":[{"_id":"56b0cbcbce5f410d0056c9c7","ref":"","in":"body","required":true,"desc":"Fecha de la factura. Formato yyyy-MM-dd.","default":"","type":"yyyy-mm-dd","name":"date"},{"_id":"56b0cd936d004b17008065cf","ref":"","in":"body","required":true,"desc":"Fecha de vencimiento de la factura. Formato yyyy-MM-dd.","default":"","type":"yyyy-mm-dd","name":"dueDate"},{"_id":"56b0cd936d004b17008065ce","ref":"","in":"body","required":false,"desc":"Observaciones de la factura (no visibles en el pdf o documento impreso). Longitud máxima permitida: 500.","default":"","type":"string","name":"observations"},{"_id":"56b0cd936d004b17008065cd","ref":"","in":"body","required":false,"desc":"Notas de la factura, visibles en el PDF o documento impreso. Longitud máxima permitida: 500.","default":"","type":"string","name":"anotation"},{"_id":"56b0cd936d004b17008065cc","ref":"","in":"body","required":false,"desc":"Términos y condiciones de la factura. Longitud máxima permitida: 500.","default":"","type":"string","name":"termsConditions"},{"_id":"56b0cd936d004b17008065cb","ref":"","in":"body","required":false,"desc":"Estado de la factura, las opciones posibles son: open o draft.  Si no se envía este atributo y no se envían pagos asociados la factura se crea en 'draft'.  Si se envían pagos a la factura, la factura queda creada en 'open'.","default":"draft","type":"string","name":"status"},{"_id":"56b0cd936d004b17008065ca","ref":"","in":"body","required":true,"desc":"Objecto que contiene el id del cliente asociado a la factura. Se puede enviar directamente el id del cliente en este atributo.","default":"","type":"mixed","name":"client"},{"_id":"56b210797ae4550d00062925","ref":"","in":"body","required":false,"desc":"Objeto que contiene la información de la numeración de la factura. Para numeraciones automáticas solo debe incluir el id de la numeración, para numeraciones manuales se debe enviar como mínimo el id de la numeración y el número de la factura. Si no se envía este atributo la aplicación intenta crear la factura con la numeración preferida que tiene configurada la empresa. Si no es posible retorna error.","default":"","type":"mixed","name":"numberTemplate"},{"_id":"56b210797ae4550d00062924","ref":"","in":"body","required":true,"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; `discount (decimal)`: porcentaje de descuento aplicado al producto, éste no debe incluir el símbolo %, únicamente su tasa. El precio del producto/servicio no debe incluir impuestos ni descuentos.","default":"","type":"array_object","name":"items"},{"_id":"56b210797ae4550d00062923","ref":"","in":"body","required":false,"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.","default":"","type":"array_object","name":"retentions"},{"_id":"56b210797ae4550d00062922","ref":"","in":"body","required":false,"desc":"Objeto que indica el id del vendedor asociado a la factura. Se puede enviar directamente el id del vendedor en este atributo.","default":"","type":"mixed","name":"seller"},{"_id":"56b210797ae4550d00062921","ref":"","in":"body","required":false,"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.","default":"","type":"mixed","name":"priceList"},{"_id":"56b210cf3b6f690d00bdb6a9","ref":"","in":"body","required":false,"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.","default":"","type":"object","name":"currency"},{"_id":"56b210cf3b6f690d00bdb6a8","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 a la cual debe ingresar el dinero; `amount (number, obligatorio)`: valor pagado.; `paymentMethod (string)`: método de pago, las opciones posibles son: transefer, 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":"string","name":"payments"},{"_id":"59499f9cf4a8980024dd0763","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":"59bc2f677c3f420010f966b5","ref":"","in":"body","required":true,"desc":"Para méxico, representa el método de pago de la factura.  Las opciones posibles son: `cash`  Efectivo,  `debit-card` Tarjeta débito, `credit-card` Tarjeta de crédito,  `service-card` Tarjeta de servicio, `transfer` Transferencia electónica, `check` Cheque nominativo, `electronic-wallet` Monedero electrónico, `electronic-money` Dinero electrónico, `grocery-voucher` Vale de despensa, `other` Otros","default":"","type":"string","name":"paymentMethod (méxico)"},{"_id":"59bc2f677c3f420010f966b4","ref":"","in":"body","required":true,"desc":"Para méxico, representa  el número de cuenta o tarjeta de pago. Debe tener mínimo 4 caracteres.","default":"","type":"string","name":"accountNumber (méxico)"},{"_id":"59bc2f677c3f420010f966b3","ref":"","in":"body","required":false,"desc":"Para méxico, El objeto stamp indica que se desea timbrar la factura en Alegra o que se está ingresando una factura que ya contiene timbre.    Si se desea timbrar la factura en Alegra, se debe mandar este objeto con los siguientes atributos :  * `generateStamp (boolean)` : Enviar en true para indicar que se desea timbrar la factura en la aplicación.  Se debe tener en cuenta que la compañía debe tener configurada la información del certificado y llave privada para timbrar la factura correctamente.   Nota: Se debe tener en cuenta que si se desea timbrar 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 timbrar la factura junto con la factura creada.  En el ejemplo \"México -Proceso timbre no exitoso\" se puede observar esta situación.  Si la factura se encuentra timbrada con otro sistema se debe enviar una objeto con los siguientes atributos:  * `stampDate  (string) `: Fecha de timbre de la factura (Formato yyyy-MM-ddThh:mm:ss). * `uuid (string) `: UUID asociado al timbre . * `satSeal (string) `: Sello del sat. * `satCertificateNumber (string)`: Número de certificado del SAT.  * `cfdSeal (string)`: Sello del CFD. * `expeditionPlace (string)` :  Lugar de expedición. *  `datetime (string)` : Fecha y hora de creación de la factura. (Formato yyyy-MM-dd hh:mm:ss). *  `certificateNumber (string)` : Número serial del certificado de la compañía usado para timbrar la factura.","default":"","type":"object","name":"stamp (méxico)"},{"_id":"59bc2f677c3f420010f966b2","ref":"","in":"body","required":false,"desc":"Para perú, El objeto stamp indica que se desea emitir la factura en Alegra.    Si se desea emitir la factura en Alegra, se debe mandar este objeto con los siguientes atributos :  * `generateStamp (boolean)` : Enviar en true para indicar que se desea emitir la factura en la aplicación.  Se debe tener en cuenta que la compañía debe haber configurado a Carvajal como PSE ante SUNAT y asociar una numeración electrónica a la factura.   Nota: Se debe tener en cuenta que si se desea emitir 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 emitir la factura junto con la factura creada.  En el ejemplo \"Perú -Proceso de emisión no exitoso\" se puede observar esta situación.","default":"","type":"object","name":"stamp (perú)"}],"url":"/invoices"},"isReference":true,"order":4,"body":"","excerpt":"","slug":"crear-factura-de-venta","type":"endpoint","title":"Crear factura de venta"}

postCrear factura de venta


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 (no visibles en el pdf o documento impreso). Longitud máxima permitida: 500.
anotation:
string
Notas de la factura, visibles en el PDF o documento impreso. Longitud máxima permitida: 500.
termsConditions:
string
Términos y condiciones de la factura. Longitud máxima permitida: 500.
status:
stringdraft
Estado de la factura, las opciones posibles son: open o draft. Si no se envía este atributo y no se envían pagos asociados la factura se crea en 'draft'. Si se envían pagos a la factura, la factura queda creada en 'open'.
client:
required
mixed
Objecto que contiene el id del cliente asociado a la factura. Se puede enviar directamente el id del cliente en este atributo.
numberTemplate:
mixed
Objeto que contiene la información de la numeración de la factura. Para numeraciones automáticas solo debe incluir el id de la numeración, para numeraciones manuales se debe enviar como mínimo el id de la numeración y el número de la factura. Si no se envía este atributo la aplicación intenta crear la factura con la numeración preferida que tiene configurada la empresa. Si no es posible retorna error.
items:
required
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; `discount (decimal)`: porcentaje de descuento aplicado al producto, éste no debe incluir el símbolo %, únicamente su tasa. El precio del producto/servicio no debe incluir impuestos ni descuentos.
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.
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.
payments:
string
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 a la cual debe ingresar el dinero; `amount (number, obligatorio)`: valor pagado.; `paymentMethod (string)`: método de pago, las opciones posibles son: transefer, 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.
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:
required
string
Para méxico, representa el método de pago de la factura. Las opciones posibles son: `cash` Efectivo, `debit-card` Tarjeta débito, `credit-card` Tarjeta de crédito, `service-card` Tarjeta de servicio, `transfer` Transferencia electónica, `check` Cheque nominativo, `electronic-wallet` Monedero electrónico, `electronic-money` Dinero electrónico, `grocery-voucher` Vale de despensa, `other` Otros
accountNumber:
required
string
Para méxico, representa el número de cuenta o tarjeta de pago. Debe tener mínimo 4 caracteres.
stamp:
object
Para méxico, El objeto stamp indica que se desea timbrar la factura en Alegra o que se está ingresando una factura que ya contiene timbre. Si se desea timbrar la factura en Alegra, se debe mandar este objeto con los siguientes atributos : * `generateStamp (boolean)` : Enviar en true para indicar que se desea timbrar la factura en la aplicación. Se debe tener en cuenta que la compañía debe tener configurada la información del certificado y llave privada para timbrar la factura correctamente. Nota: Se debe tener en cuenta que si se desea timbrar 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 timbrar la factura junto con la factura creada. En el ejemplo "México -Proceso timbre no exitoso" se puede observar esta situación. Si la factura se encuentra timbrada con otro sistema se debe enviar una objeto con los siguientes atributos: * `stampDate (string) `: Fecha de timbre de la factura (Formato yyyy-MM-ddThh:mm:ss). * `uuid (string) `: UUID asociado al timbre . * `satSeal (string) `: Sello del sat. * `satCertificateNumber (string)`: Número de certificado del SAT. * `cfdSeal (string)`: Sello del CFD. * `expeditionPlace (string)` : Lugar de expedición. * `datetime (string)` : Fecha y hora de creación de la factura. (Formato yyyy-MM-dd hh:mm:ss). * `certificateNumber (string)` : Número serial del certificado de la compañía usado para timbrar la factura.
stamp:
object
Para perú, El objeto stamp indica que se desea emitir la factura en Alegra. Si se desea emitir la factura en Alegra, se debe mandar este objeto con los siguientes atributos : * `generateStamp (boolean)` : Enviar en true para indicar que se desea emitir la factura en la aplicación. Se debe tener en cuenta que la compañía debe haber configurado a Carvajal como PSE ante SUNAT y asociar una numeración electrónica a la factura. Nota: Se debe tener en cuenta que si se desea emitir 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 emitir la factura junto con la factura creada. En el ejemplo "Perú -Proceso de emisión no exitoso" se puede observar esta situación.

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