{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/invoices","auth":"required","method":"post","params":[{"name":"date","type":"yyyy-mm-dd","default":"","desc":"Fecha de la factura. Formato yyyy-MM-dd.","required":true,"in":"body","ref":"","_id":"56b0cbcbce5f410d0056c9c7"},{"name":"dueDate","type":"yyyy-mm-dd","default":"","desc":"Fecha de vencimiento de la factura. Formato yyyy-MM-dd.","required":true,"in":"body","ref":"","_id":"56b0cd936d004b17008065cf"},{"name":"observations","type":"string","default":"","desc":"Observaciones de la factura (no visibles en el pdf o documento impreso). Longitud máxima permitida: 500.","required":false,"in":"body","ref":"","_id":"56b0cd936d004b17008065ce"},{"name":"anotation","type":"string","default":"","desc":"Notas de la factura, visibles en el PDF o documento impreso. Longitud máxima permitida: 500.","required":false,"in":"body","ref":"","_id":"56b0cd936d004b17008065cd"},{"name":"termsConditions","type":"string","default":"","desc":"Términos y condiciones de la factura. Longitud máxima permitida: 500.","required":false,"in":"body","ref":"","_id":"56b0cd936d004b17008065cc"},{"name":"status","type":"string","default":"draft","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'.","required":false,"in":"body","ref":"","_id":"56b0cd936d004b17008065cb"},{"name":"client","type":"mixed","default":"","desc":"Objecto que contiene el id del cliente asociado a la factura. Se puede enviar directamente el id del cliente en este atributo.","required":true,"in":"body","ref":"","_id":"56b0cd936d004b17008065ca"},{"name":"numberTemplate","type":"mixed","default":"","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. Para la creación de tickets de venta (México) es necesario enviar la numeración de tipo Ticket de venta.","required":false,"in":"body","ref":"","_id":"56b210797ae4550d00062925"},{"name":"items","type":"array_object","default":"","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 Para costa rica, el atributo `discount` pasa a ser un objeto compuesto por los atributos: `nature` (indica la naturaleza del descuento) y `discount` (indica la tasa del descuento). El precio del producto/servicio no debe incluir impuestos ni descuentos; `importRequest (string)` : Solo para Mexico se puede enviar el número de pedimento si el item lo tiene activo, este debe contener 21 caracteres y debe seguir el formato: 99  99  9999  9999999. Utilizando 2 espacios para separar cada conjunto de caracteres.","required":true,"in":"body","ref":"","_id":"56b210797ae4550d00062924"},{"name":"retentions","type":"array_object","default":"","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.","required":false,"in":"body","ref":"","_id":"56b210797ae4550d00062923"},{"name":"seller","type":"mixed","default":"","desc":"Objeto que indica el id del vendedor asociado a la factura. Se puede enviar directamente el id del vendedor en este atributo.","required":false,"in":"body","ref":"","_id":"56b210797ae4550d00062922"},{"name":"priceList","type":"mixed","default":"","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.","required":false,"in":"body","ref":"","_id":"56b210797ae4550d00062921"},{"name":"currency","type":"object","default":"","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.","required":false,"in":"body","ref":"","_id":"56b210cf3b6f690d00bdb6a9"},{"name":"payments","type":"array_object","default":"","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.","required":false,"in":"body","ref":"","_id":"56b210cf3b6f690d00bdb6a8"},{"name":"warehouse","type":"mixed","default":"","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.","required":false,"in":"body","ref":"","_id":"59499f9cf4a8980024dd0763"},{"name":"paymentMethod (México)","type":"string","default":"","desc":"Para México, representa la forma de pago de la factura.  Las opciones posibles son: `cash` Efectivo, `debit-card` Tarjeta de débito, `credit-card` Tarjeta de crédito, `service-card` Tarjeta de servicios, `transfer` Transferencia electrónica de fondos, `check` Cheque nominativo, `electronic-wallet` Monedero electrónico, `electronic-money` Dinero electrónico, `grocery-voucher` Vale de despensa, `dation-payment` Dación en pago, `subrogation-payment` Pago por subrogación, `allocation-payment` Pago por consignación, `forgiveness` Condonación, `compensation` Compensación, `novation` Novación, `misunderstanding` Confusión, `debt-remission` Remisión de deuda, `prescription-or-expiration` Prescripción o caducidad, `creditor-satisfaction` A satisfacción del acreedor. Si el paymentType es \"PPD\" solo admite el paymentMethod `other` Por Definir.","required":true,"in":"body","ref":"","_id":"59bc2f677c3f420010f966b5"},{"name":"paymentMethod (Costa Rica)","type":"string","default":"","desc":"Para Costa Rica, indica el método de pago de la factura.  Las opciones posibles son: `cash`  Efectivo,  `card` Tarjeta débito/crédito,  `check` Cheque,  `transfer` Transferencia - depósito bancario,  `collection-by-third` Recaudo por teceros,  `other` Otros métodos de pago. Si se desea emitir la factura, este atributo se vuelve obligatorio.","required":false,"in":"body","ref":"","_id":"5bcf9c1c713a2000183d0ec9"},{"name":"paymentMethod (Colombia)","type":"string","default":"","desc":"Para Colombia, indica el medio de pago de la factura de venta. Sí el atributo `paymentForm` es `CASH` y la compañía tiene activa la opción de facturación electrónica 2.1, este atributo se vuelve obligatorio. Consulta el catálogo de parámetros correspondiente a cada país haciendo clic [aquí](https://developer.alegra.com/docs/colombia).","required":false,"in":"body","ref":"","_id":"5dd6c191df9bcf0011d588df"},{"name":"paymentForm (Colombia)","type":"string","default":"","desc":"Para Colombia, indica la forma de pago de la factura de venta. Admite los valores: `CASH` para efectivo y `CREDIT` para crédito. Si la compañía tiene activa la opción de facturación electrónica 2.1, este atributo se vuelve obligatorio.","required":false,"in":"body","ref":"","_id":"5dd6c3382f0e1b0056dcc29f"},{"name":"paymentForm (Chile)","type":"object","default":"","desc":"Para Chile, el objeto paymentForm indica la forma de pago de la factura, este objeto puede contener atributos:  * `id (string)` código de la forma de pago y * `value(string)` nombre de la forma de pago. Si se desea emitir la factura, este atributo se vuelve obligatorio.","required":false,"in":"body","ref":"","_id":"5e601139baeb4d001816c968"},{"name":"type","type":"string","default":"NATIONAL","desc":"Para Colombia, Costa Rica y Chile, indica el tipo de la factura de venta. Si no se envía, se asignará por defecto el código: `NATIONAL`. Consulta el catálogo de parámetros correspondiente a cada país haciendo [aquí](https://developer.alegra.com/docs/colombia#tipos-de-factura).","required":false,"in":"body","ref":"","_id":"5dd6bf91dcf655006a6537af"},{"name":"accountNumber (México)","type":"string","default":"","desc":"Para México, representa el número de cuenta o tarjeta de pago. Debe tener mínimo 4 caracteres.","required":false,"in":"body","ref":"","_id":"59bc2f677c3f420010f966b4"},{"name":"cfdiUse","type":"string","default":"","desc":"Para México, representa la clave del Uso CFDI. Puedes consultar las opciones disponibles [aquí](https://developer.alegra.com/docs/méxico)","required":false,"in":"body","ref":"","_id":"5a01dea3486b6a002823a107"},{"name":"stamp (Colombia)","type":"object","default":"","desc":"Para Colombia, el objeto stamp indica que se desea expedir/emitir la factura electrónica en Alegra.    Si se desea expedir la factura en Alegra, se debe enviar este objeto con los siguientes atributos :  * `generateStamp (boolean)` : Enviar en true para indicar que se desea expedir la factura en la aplicación.  Nota: Se debe tener en cuenta que si se desea expedir 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 expedir la factura junto con la factura creada.","required":false,"in":"body","ref":"","_id":"5bedd40ef446f8002fa4cc6d"},{"name":"stamp (México)","type":"object","default":"","desc":"Para México, el objeto stamp indica que se desea timbrar la factura electrónica 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. Los Tickets de venta no admiten este campo.","required":false,"in":"body","ref":"","_id":"59bc2f677c3f420010f966b3"},{"name":"stamp (Perú)","type":"object","default":"","desc":"Para Perú, el objeto stamp indica que se desea expedir/emitir la factura electrónica 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.","required":false,"in":"body","ref":"","_id":"59bc2f677c3f420010f966b2"},{"name":"stamp (Costa Rica)","type":"object","default":"","desc":"Para Costa Rica, el objeto stamp indica que se desea expedir/emitir la factura electrónica en Alegra.    Si se desea emitir la factura en Alegra, se debe enviar este objeto con los siguientes atributos :  * `generateStamp (boolean)` : Enviar en true para indicar que se desea emitir la factura en la aplicación.  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 expedir la factura junto con la factura creada.","required":false,"in":"body","ref":"","_id":"5bcf9c1c713a2000183d0ec8"},{"name":"stamp (Argentina)","type":"object","default":"","desc":"Para Argentina, el objeto stamp indica que se desea expedir/emitir la factura electrónica en Alegra.  Si se desea emitir la factura en Alegra, se debe enviar este objeto con los siguientes atributos :  * `generateStamp (boolean)` : Enviar en true para indicar que se desea emitir la factura en la aplicación.  Nota: Se debe tener en cuenta que si se desea expedir 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 expedir la factura junto con la factura creada.","required":false,"in":"body","ref":"","_id":"5dd6f06f6a9efe0047538571"},{"name":"stamp (Chile)","type":"object","default":"","desc":"Para Chile, el objeto stamp indica que se desea expedir/emitir la factura electrónica en Alegra. Si se desea emitir la factura en Alegra, se debe enviar este objeto con el atributo :  * `generateStamp (boolean)` : Enviar en true para indicar que se desea emitir la factura en la aplicación.  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 expedir la factura junto con la factura creada.","required":false,"in":"body","ref":"","_id":"5e601369cc051900121f2244"},{"name":"paymentType (México)","type":"string","default":"","desc":"Para México, representa el método de la factura. Admite los valores `PUE` para Pago en Una sola Exhibición y `PPD` para Pago en Parcialidades o Diferido.","required":false,"in":"body","ref":"","_id":"5a7077f732d133001289d70b"},{"name":"saleCondition (Costa Rica)","type":"string","default":"","desc":"Para Costa Rica, indica la condición de la venta. Consulta el catálogo de parámetros correspondiente a cada país haciendo clic [aquí](https://developer.alegra.com/docs/costa-rica). Si se desea emitir la factura, este atributo se vuelve obligatorio.","required":false,"in":"body","ref":"","_id":"5bcf9c1c713a2000183d0ec7"},{"name":"saleCondition (Argentina)","type":"string","default":"","desc":"Para Argentina, indica la condición de la venta.  Las opciones posibles son: `CASH` Efectivo, `DEBIT_CARD` Tarjeta Debito, `CREDIT_CARD` Tarjeta Crédito, `DEPOSIT` Depósito,  `TRANSFER` Transferencia. Si se desea emitir la factura, este atributo se vuelve obligatorio.","required":false,"in":"body","ref":"","_id":"5dd6f06f6a9efe0047538570"},{"name":"operationType (Perú)","type":"string","default":"","desc":"Para Perú, indica el tipo de operación de la venta. Consulta el catálogo de parámetros correspondiente a cada país haciendo clic [aquí](https://developer.alegra.com/docs/perú).","required":false,"in":"body","ref":"","_id":"5c2ccf250217cf001f68ec2f"},{"name":"operationType (Colombia)","type":"string","default":"","desc":"Para Colombia, indica el tipo de operación de la factura de venta. Si no se envía, se asignará por defecto el código: `STANDARD`.","required":false,"in":"body","ref":"","_id":"5dd6c191df9bcf0011d588de"},{"name":"economicActivity (Costa Rica)","type":"int","default":"","desc":"Para Costa Rica, indica el código de la actividad económica asociada a la factura. Si no se envía, se asignará por defecto el código de la actividad económica de la compañía.","required":false,"in":"body","ref":"","_id":"5d684663ff4e1203e2979455"},{"name":"economicActivity (Chile)","type":"object","default":"","desc":"Para Chile, el objeto economicActivity indica la actividad económica de la compañía, este objeto puede contener atributos:  * `id (string)` código de la actividad económica y * `value(string)` nombre de la actividad económica. Si no es envía este atributo, se enviará la actividad económica de la compañía. Si se desea emitir la factura, este atributo se vuelve obligatorio.","required":false,"in":"body","ref":"","_id":"5e601369cc051900121f223d"},{"name":"remissions","type":"array_int","default":"","desc":"Array de identificadores de las remisiones que se desean facturar, puedes asociar una o varias remisiones tan solo indicando el id de cada una en un array. El cliente de las remisiones y de la factura de venta debe ser el mismo. Solo las remisiones abiertas pueden ser facturadas. De esta forma, los ítems de cada una de las remisiones serán facturados, además también podrás especificar otros ítems con el parametro`items`.","required":false,"in":"body","ref":"","_id":"5dae18d7d546dd00393b9ffb"},{"name":"estimate","type":"int","default":"","desc":"Especifica el identificador de la cotización que desea asociar a la factura de venta, de esta forma, la cotización queda facturada y se asocian los ítems que se especifiquen en el parametro `items` no los que tiene la cotización.","required":false,"in":"body","ref":"","_id":"5dae1ca172dc6c003bfd19e5"},{"name":"saleConcept (Argentina)","type":"string","default":"","desc":"Para Argentina, indica el concepto de venta asociado a la factura. Las opciones posibles son:  `PRODUCTS` Productos, `SERVICES` Servicios, `PRODUCTS_SERVICES` Productos y Servicios. Si se desea emitir la factura, este atributo se vuelve obligatorio.","required":false,"in":"body","ref":"","_id":"5dd6f06f6a9efe004753856f"},{"name":"startDateService (Argentina)","type":"yyyy-mm-dd","default":"","desc":"Para Argentina, indica la fecha de inicio de la factura.Si se desea emitir la factura, este atributo se vuelve obligatorio.","required":false,"in":"body","ref":"","_id":"5dd6f06f6a9efe004753856e"},{"name":"endDateService (Argentina)","type":"yyyy-mm-dd","default":"","desc":"Para Argentina, indica la fecha final de la factura. Si se desea emitir la factura, este atributo se vuelve obligatorio.","required":false,"in":"body","ref":"","_id":"5dd6f06f6a9efe004753856d"},{"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":"5ea9cdac2f727c002b0ed0c5"}],"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  \"costCenter\": {\n     \"id\": \"2\",\n     \"code\": \"CC01\",\n     \"name\": \"Centro de costo ventas general\",\n     \"description\": \"Ingresos y gastos de ventas generales\",\n     \"status\": \"active\" \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    \"cfdiUse\" : \"G01\",\n    \"paymentMethod\" : \"other\",\n    \"paymentType\": \"PPD\",\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\": \"[email protected]\",\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\": \"[email protected]\",\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":[{"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}","language":"json","name":"Factura sencilla"},{"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  \"remissions\": [10,20],\n  \"estimate\": 5,\n  \"costCenter\" : {\n    \"id\" : 2\n  },\n} ","language":"json","name":"Factura completa"},{"language":"curl","code":"curl -v -H \"Accept: application/json\" -H \"Content-type: application/json\" -X POST  https://api.alegra.com/api/v1/invoices/ -u '[email protected]: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":"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    }, \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  \"cfdiUse\" : \"G01\",\n  \"paymentType\" : \"PUE\",\n  \"paymentMethod\": \"cash\", \n  \"stamp\": {\n    \"generateStamp\": true\n  }\n}","name":"Factura Mexico para timbrar en la aplicación"},{"name":"Factura sencilla para emitir en la aplicació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":"java","code":"import java.io.PrintWriter;\nimport java.io.BufferedReader;\nimport java.io.IOException;\nimport java.io.InputStreamReader;\nimport java.net.URL;\nimport java.net.URLConnection;\nimport java.util.Base64;\nimport java.util.Base64.Encoder;\n\npublic class AlegraInvoiceAdd {\n    // Credenciales de alegra tomados desde:\n    // https://api.alegra.com/configuration/api\n    public static final String USER_EMAIL = \"\"; // Email de la cuenta de alegra\n    public static final String USER_TOKEN = \"\"; // Token para consumo de la API\n    \n    public static String doPost(String auth, String url, String postData) {\n        PrintWriter out = null;\n        BufferedReader in = null;\n        String result = \"\";\n\n        try {\n            URL realUrl = new URL(url);\n            // build connection\n            URLConnection conn = realUrl.openConnection();\n            // set request properties\n            conn.setRequestProperty(\"Authorization\", \"Basic \" + auth);\n            // enable output and input\n            conn.setDoOutput(true);\n            conn.setDoInput(true);\n            out = new PrintWriter(conn.getOutputStream());\n            // send POST DATA\n            out.print(postData);\n            out.flush();\n            in = new BufferedReader(new InputStreamReader(conn.getInputStream()));\n            String line;\n            while ((line = in.readLine()) != null) {\n                result += \"/n\" + line;\n            }\n        } catch (Exception e) {\n            e.printStackTrace();\n        }\n        finally {\n            try {\n                if (out != null) {\n                    out.close();\n                }\n                if (in != null) {\n                    in.close();\n                }\n            } catch (IOException ex) {\n                ex.printStackTrace();\n            }\n        }\n        return result;\n    }\n    \n    public static void main(String[] args) {\n        // Generamos el token de autenticación que es el resulado de:\n        // base64_encode(email:token)\n        String auth = Base64.getEncoder().encodeToString((USER_EMAIL + \":\" + USER_TOKEN).getBytes());\n        \n        // Se puede crear el cuerpo del request a través de un objeto constructor, \n        // bien sea de un JSON, etc, utilizando librerías y utilidades adicionales...\n        String payload = \n            \"{\" + \n                \"\\\"date\\\": \\\"2018-07-11\\\",\" + \n                \"\\\"dueDate\\\": \\\"2018-08-11\\\",\" + \n                \"\\\"client\\\": 19,\" + \n                \"\\\"status\\\": \\\"open\\\",\" + \n                \"\\\"items\\\": [\" + \n                    \"{\" + \n                        \"\\\"id\\\": 2,\" + \n                        \"\\\"price\\\": 100,\" + \n                        \"\\\"quantity\\\": 2\" + \n                    \"}\" + \n                \"]\" + \n            \"}\";\n\n        System.out.println(doPost(auth, \"https://api.alegra.com/api/v1/invoices\", payload));\n    }\n}\n"}]}},"next":{"description":"","pages":[]},"title":"Crear factura de venta","type":"endpoint","slug":"crear-factura-de-venta","excerpt":"Endpoint que permite crear una factura de venta desde cero.","body":"","updates":["59e4b7005dd919002677a0ac"],"order":3,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"56b20eb17ae4550d0006291e","createdAt":"2016-02-03T14:29:05.166Z","editedParams":true,"category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Facturas de venta","slug":"facturas-de-venta","order":3,"from_sync":false,"reference":true,"_id":"56b4b32deed075230097d689","__v":0,"project":"56abd2434e4b730d009eb10a","createdAt":"2016-02-05T14:35:25.879Z","version":"56abd2434e4b730d009eb10d"},"parentDoc":null,"__v":72,"editedParams2":true,"githubsync":"","user":"56abd213d4432d1900eed227","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"],"_id":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a","releaseDate":"2016-01-29T20:57:39.712Z","__v":40,"createdAt":"2016-01-29T20:57:39.712Z"},"project":"56abd2434e4b730d009eb10a"}

postCrear factura de venta

Endpoint que permite crear una factura de venta desde cero.

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. Para la creación de tickets de venta (México) es necesario enviar la numeración de tipo Ticket de venta.
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 Para costa rica, el atributo `discount` pasa a ser un objeto compuesto por los atributos: `nature` (indica la naturaleza del descuento) y `discount` (indica la tasa del descuento). El precio del producto/servicio no debe incluir impuestos ni descuentos; `importRequest (string)` : Solo para Mexico se puede enviar el número de pedimento si el item lo tiene activo, este debe contener 21 caracteres y debe seguir el formato: 99 99 9999 9999999. Utilizando 2 espacios para separar cada conjunto de caracteres.
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:
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 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 la forma de pago de la factura. Las opciones posibles son: `cash` Efectivo, `debit-card` Tarjeta de débito, `credit-card` Tarjeta de crédito, `service-card` Tarjeta de servicios, `transfer` Transferencia electrónica de fondos, `check` Cheque nominativo, `electronic-wallet` Monedero electrónico, `electronic-money` Dinero electrónico, `grocery-voucher` Vale de despensa, `dation-payment` Dación en pago, `subrogation-payment` Pago por subrogación, `allocation-payment` Pago por consignación, `forgiveness` Condonación, `compensation` Compensación, `novation` Novación, `misunderstanding` Confusión, `debt-remission` Remisión de deuda, `prescription-or-expiration` Prescripción o caducidad, `creditor-satisfaction` A satisfacción del acreedor. Si el paymentType es "PPD" solo admite el paymentMethod `other` Por Definir.
paymentMethod:
string
Para Costa Rica, indica el método de pago de la factura. Las opciones posibles son: `cash` Efectivo, `card` Tarjeta débito/crédito, `check` Cheque, `transfer` Transferencia - depósito bancario, `collection-by-third` Recaudo por teceros, `other` Otros métodos de pago. Si se desea emitir la factura, este atributo se vuelve obligatorio.
paymentMethod:
string
Para Colombia, indica el medio de pago de la factura de venta. Sí el atributo `paymentForm` es `CASH` y la compañía tiene activa la opción de facturación electrónica 2.1, este atributo se vuelve obligatorio. Consulta el catálogo de parámetros correspondiente a cada país haciendo clic [aquí](https://developer.alegra.com/docs/colombia).
paymentForm:
string
Para Colombia, indica la forma de pago de la factura de venta. Admite los valores: `CASH` para efectivo y `CREDIT` para crédito. Si la compañía tiene activa la opción de facturación electrónica 2.1, este atributo se vuelve obligatorio.
paymentForm:
object
Para Chile, el objeto paymentForm indica la forma de pago de la factura, este objeto puede contener atributos: * `id (string)` código de la forma de pago y * `value(string)` nombre de la forma de pago. Si se desea emitir la factura, este atributo se vuelve obligatorio.
type:
stringNATIONAL
Para Colombia, Costa Rica y Chile, indica el tipo de la factura de venta. Si no se envía, se asignará por defecto el código: `NATIONAL`. Consulta el catálogo de parámetros correspondiente a cada país haciendo [aquí](https://developer.alegra.com/docs/colombia#tipos-de-factura).
accountNumber:
string
Para México, representa el número de cuenta o tarjeta de pago. Debe tener mínimo 4 caracteres.
cfdiUse:
string
Para México, representa la clave del Uso CFDI. Puedes consultar las opciones disponibles [aquí](https://developer.alegra.com/docs/méxico)
stamp:
object
Para Colombia, el objeto stamp indica que se desea expedir/emitir la factura electrónica en Alegra. Si se desea expedir la factura en Alegra, se debe enviar este objeto con los siguientes atributos : * `generateStamp (boolean)` : Enviar en true para indicar que se desea expedir la factura en la aplicación. Nota: Se debe tener en cuenta que si se desea expedir 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 expedir la factura junto con la factura creada.
stamp:
object
Para México, el objeto stamp indica que se desea timbrar la factura electrónica 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. Los Tickets de venta no admiten este campo.
stamp:
object
Para Perú, el objeto stamp indica que se desea expedir/emitir la factura electrónica 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.
stamp:
object
Para Costa Rica, el objeto stamp indica que se desea expedir/emitir la factura electrónica en Alegra. Si se desea emitir la factura en Alegra, se debe enviar este objeto con los siguientes atributos : * `generateStamp (boolean)` : Enviar en true para indicar que se desea emitir la factura en la aplicación. 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 expedir la factura junto con la factura creada.
stamp:
object
Para Argentina, el objeto stamp indica que se desea expedir/emitir la factura electrónica en Alegra. Si se desea emitir la factura en Alegra, se debe enviar este objeto con los siguientes atributos : * `generateStamp (boolean)` : Enviar en true para indicar que se desea emitir la factura en la aplicación. Nota: Se debe tener en cuenta que si se desea expedir 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 expedir la factura junto con la factura creada.
stamp:
object
Para Chile, el objeto stamp indica que se desea expedir/emitir la factura electrónica en Alegra. Si se desea emitir la factura en Alegra, se debe enviar este objeto con el atributo : * `generateStamp (boolean)` : Enviar en true para indicar que se desea emitir la factura en la aplicación. 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 expedir la factura junto con la factura creada.
paymentType:
string
Para México, representa el método de la factura. Admite los valores `PUE` para Pago en Una sola Exhibición y `PPD` para Pago en Parcialidades o Diferido.
saleCondition:
string
Para Costa Rica, indica la condición de la venta. Consulta el catálogo de parámetros correspondiente a cada país haciendo clic [aquí](https://developer.alegra.com/docs/costa-rica). Si se desea emitir la factura, este atributo se vuelve obligatorio.
saleCondition:
string
Para Argentina, indica la condición de la venta. Las opciones posibles son: `CASH` Efectivo, `DEBIT_CARD` Tarjeta Debito, `CREDIT_CARD` Tarjeta Crédito, `DEPOSIT` Depósito, `TRANSFER` Transferencia. Si se desea emitir la factura, este atributo se vuelve obligatorio.
operationType:
string
Para Perú, indica el tipo de operación de la venta. Consulta el catálogo de parámetros correspondiente a cada país haciendo clic [aquí](https://developer.alegra.com/docs/perú).
operationType:
string
Para Colombia, indica el tipo de operación de la factura de venta. Si no se envía, se asignará por defecto el código: `STANDARD`.
economicActivity:
integer
Para Costa Rica, indica el código de la actividad económica asociada a la factura. Si no se envía, se asignará por defecto el código de la actividad económica de la compañía.
economicActivity:
object
Para Chile, el objeto economicActivity indica la actividad económica de la compañía, este objeto puede contener atributos: * `id (string)` código de la actividad económica y * `value(string)` nombre de la actividad económica. Si no es envía este atributo, se enviará la actividad económica de la compañía. Si se desea emitir la factura, este atributo se vuelve obligatorio.
remissions:
array of integers
Array de identificadores de las remisiones que se desean facturar, puedes asociar una o varias remisiones tan solo indicando el id de cada una en un array. El cliente de las remisiones y de la factura de venta debe ser el mismo. Solo las remisiones abiertas pueden ser facturadas. De esta forma, los ítems de cada una de las remisiones serán facturados, además también podrás especificar otros ítems con el parametro`items`.
estimate:
integer
Especifica el identificador de la cotización que desea asociar a la factura de venta, de esta forma, la cotización queda facturada y se asocian los ítems que se especifiquen en el parametro `items` no los que tiene la cotización.
saleConcept:
string
Para Argentina, indica el concepto de venta asociado a la factura. Las opciones posibles son: `PRODUCTS` Productos, `SERVICES` Servicios, `PRODUCTS_SERVICES` Productos y Servicios. Si se desea emitir la factura, este atributo se vuelve obligatorio.
startDateService:
yyyy-mm-dd
Para Argentina, indica la fecha de inicio de la factura.Si se desea emitir la factura, este atributo se vuelve obligatorio.
endDateService:
yyyy-mm-dd
Para Argentina, indica la fecha final de la factura. Si se desea emitir la factura, este atributo se vuelve obligatorio.
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.

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