{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/number-templates/{id}","auth":"required","examples":{"codes":[]},"params":[],"results":{"codes":[]},"settings":""},"next":{"description":"","pages":[]},"title":"Descripción general","type":"basic","slug":"numeración-de-facturación","excerpt":"Endpoint /number-templates","body":"Los usuarios pueden registrar en la aplicación diferentes numeraciones o folios para facturar. Para saber más información sobre la configuración de numeraciones haz clic [aquí](http://ayuda.alegra.com/hc/es/articles/206445985-Configuraci%C3%B3n-de-la-Numeraci%C3%B3n-de-tus-comprobantes-en-Alegra).\n\nEste recurso está definido en el API como`number-template` y se puede consultar para asociar las facturas nuevas a diferentes numeraciones.\n\nSe debe tener en cuenta que en la creación de facturas, si no se envía el parámetro `numberTemplate`, la aplicación asociará la factura de venta a la numeración que se tenga como preferida siempre y cuando esta numeración esté configurada como automática (haz clic [aquí](http://ayuda.alegra.com/hc/es/articles/205737469-Configuraci%C3%B3n-de-Numeraci%C3%B3n-y-folios-de-Facturas) para saber más) y le asignará el siguiente número de facturación que corresponda. \n\nUna numeración (numberTemplate) contiene los siguientes atributos:\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Nombre\",\n    \"h-1\": \"Tipo\",\n    \"h-2\": \"Descripción\",\n    \"h-3\": \"Ejemplo\",\n    \"3-0\": \"nextInvoiceNumber\",\n    \"3-1\": \"Integer\",\n    \"3-2\": \"Siguiente número disponible para facturar.  Este atributo solo se popula cuando la numeración esta configurada como automática.\",\n    \"3-3\": \"150\",\n    \"5-0\": \"invoiceText\",\n    \"0-0\": \"id\",\n    \"0-1\": \"Integer\",\n    \"0-2\": \"Identificador único que representa una numeración específica.  La aplicación lo asigna automáticamente.\",\n    \"0-3\": \"1\",\n    \"1-2\": \"Nombre con el cual está identificada la numeración.\",\n    \"2-2\": \"Prefijo asociado a la numeración. Las facturas creadas con esta numeración se les asignará automáticamente el prefijo indicado.\",\n    \"1-0\": \"name\",\n    \"2-0\": \"prefix\",\n    \"2-3\": \"AL-\",\n    \"2-1\": \"String\",\n    \"1-1\": \"String\",\n    \"5-2\": \"Texto de la numeración. En versión Alegra Colombia este atributo equivale a la resolución de facturación de la factura de venta.\",\n    \"5-3\": \"Resolución de la DIAN # 45112\",\n    \"6-0\": \"isDefault\",\n    \"6-2\": \"Indica si la numeración es la preferida. Sólo puede existir una numeración como preferida.\",\n    \"5-1\": \"String\",\n    \"6-1\": \"Boolean\",\n    \"6-3\": \"true\",\n    \"7-0\": \"status\",\n    \"7-2\": \"Estado de la numeración.  Puede ser active o inactive. Las numeraciones inactivas no pueden ser utilizadas en la creación de facturas de venta.\",\n    \"7-3\": \"active\",\n    \"8-0\": \"autoincrement\",\n    \"8-1\": \"Boolean\",\n    \"8-2\": \"Indica si la numeración incrementa automáticamente o se debe indicar el número de la factura.\",\n    \"8-3\": \"true\",\n    \"1-3\": \"Almacén Oriente\",\n    \"4-0\": \"maxInvoiceNumber\",\n    \"4-1\": \"Integer\",\n    \"4-2\": \"Número final para facturar.\\nEste atributo solo se popula cuando la numeración esta configurada como automática.\",\n    \"4-3\": \"300\",\n    \"9-0\": \"isElectronic\",\n    \"9-1\": \"Boolean\",\n    \"9-2\": \"Indica si la numeración es electrónica.\",\n    \"9-3\": \"true\",\n    \"10-0\": \"documentType\",\n    \"10-1\": \"String\",\n    \"10-2\": \"Indica el tipo de documento de la numeración, los valores posibles son: \\n\\nGeneral:\\n- \\\"invoice\\\" (Factura de venta)\\n\\nRepublica Dominicana:\\n- \\\"transactonIn\\\" (Recibo de caja)\\n- \\\"transactionOut\\\" (Comprobante de egreso)\\n- \\\"creditNote\\\" (Nota crédito)\\n- \\\"debitNote\\\" (Nota débito)\\n- \\\"remission\\\" (Remisión)\\n- \\\"purchaseOrder\\\" (Orden de compra)\\n- \\\"estimate\\\" (Cotización)\\n\\n\\n\\nPerú:\\n- \\\"invoice\\\" (Factura de venta)\\n- \\\"saleTicket\\\" (Boleta de venta)\\n\\n\\nColombia:\\n- \\\"invoice\\\" (Factura de venta)\\n- \\\"saleTicket\\\" (Documento equivalente P.O.S.)\\n- \\\"supportDocument\\\" (Documento soporte)\",\n    \"10-3\": \"invoice\",\n    \"11-0\": \"branchOffice (Republica Dominicana)\",\n    \"11-1\": \"String\",\n    \"11-2\": \"Indica la sucursal asociada a la numeración.\\n\\nEste campo es exclusivo para numeraciones de facturas (invoice) y notas crédito (creditNote).\",\n    \"11-3\": \"Principal\",\n    \"13-0\": \"startDate\",\n    \"13-1\": \"String. Formato yyyy-MM-dd\",\n    \"13-2\": \"Para la versión de Republica Dominicana y Colombia.\\n\\nFecha de inicio de la resolución que autoriza la numeración.\\n\\nEste campo es exclusivo para numeraciones de facturas (invoice).\",\n    \"13-3\": \"2018-02-02\",\n    \"14-0\": \"endDate\",\n    \"14-1\": \"String. Formato yyyy-MM-dd\",\n    \"14-2\": \"Para la versión de Republica Dominicana y Colombia.\\n\\nFecha final de la resolución que autoriza la numeración.\\n\\nEste campo es exclusivo para numeraciones de facturas (invoice).\",\n    \"14-3\": \"2018-02-03\",\n    \"15-0\": \"resolutionNumber (Colombia)\",\n    \"15-1\": \"Integer\",\n    \"15-2\": \"Para la versión de Colombia.\\n\\nIndica el número de resolución que autoriza la numeración.\",\n    \"16-0\": \"subDocumentType\",\n    \"16-1\": \"String\",\n    \"16-2\": \"Para la versión de Chile, Costa Rica, Argentina y Republica Dominicana.\\n\\nActualmente se usa para invoice (actualmente factura de venta y boletas para Chile, para Costa Rica facutras de venta, para Argentina factura de venta, nota crédito, nota débito y presupuesto y para Rep. Dominicana en factura de venta, nota crédito, nota débito, pagos y gastos) . Indica un tipo de factura, por ejemplo: factura exenta. **Para modificar el tipo de factura a factura de venta, se debe enviar el parámetro vació (\\\"\\\") o si se envía un valor inexistente, se tomará como factura de venta**.\\n\\nConsulta el listado de valores para subDocumentType en [Chile](https://developer.alegra.com/docs/chile), [Costa Rica](https://developer.alegra.com/docs/costa-rica), [Argentina](https://developer.alegra.com/docs/argentina) y [República Dominicana (https://developer.alegra.com/docs/república-dominicana)\",\n    \"16-3\": \"EXEMPT_INVOICE\",\n    \"12-0\": \"branchOfficeCode (Panamá)\",\n    \"12-1\": \"String\",\n    \"12-2\": \"Indica el código de sucursal asociado a la numeración.\\n\\nEste campo es exclusivo para numeraciones electrónicas de facturas (invoice) y notas crédito (creditNote).\",\n    \"12-3\": \"0001\"\n  },\n  \"cols\": 4,\n  \"rows\": 17\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Versión Alegra Perú\",\n  \"body\": \"Para Perú, si la numeración es electrónica, el atributo \\\"prefix\\\" es obligatorio y debe cumplir con las siguientes reglas.\\n\\n  * Longitud de 4 caracteres.\\n  * Iniciar con la letra \\\"F\\\" en mayúscula.\"\n}\n[/block]","updates":[],"order":0,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"56b224cd2d9646170059921a","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","5f3c4814ac3e6209c38b7615","5f4fbe7281626c006887f104","5f5242887d2f8701ff580d22","5fc1133c51c8370081b28e2a"],"_id":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a","releaseDate":"2016-01-29T20:57:39.712Z","__v":44,"createdAt":"2016-01-29T20:57:39.712Z"},"createdAt":"2016-02-03T16:03:25.714Z","parentDoc":null,"user":"56abd213d4432d1900eed227","project":"56abd2434e4b730d009eb10a","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Numeración de facturación","slug":"numeración-de-facturación","order":5,"from_sync":false,"reference":true,"_id":"56b4b37327d9c00d005d6bc4","project":"56abd2434e4b730d009eb10a","version":"56abd2434e4b730d009eb10d","createdAt":"2016-02-05T14:36:35.335Z","__v":0},"githubsync":"","__v":11}

Documentación

Productos o servicios

Contactos

Facturas de venta

Cotizaciones

Numeración de facturación

Impuestos

Cuentas de banco

Empresa

Pagos

Retenciones

Categorías de items

Cuentas contables

Vendedores

Listas de precios

Bodegas

Usuarios

Facturas globales

Términos de pago

Ajustes contables

Monedas

Facturas de Proveedor

Notas Crédito

Notas Débito

Remisiones

Órdenes de Compra

Centros de Costos

Reportes

Campos adicionales

Atributos variantes en items

Conciliaciones

Ajustes generales

Catálogo de parámetros por país

Descripción general

Endpoint /number-templates
Los usuarios pueden registrar en la aplicación diferentes numeraciones o folios para facturar. Para saber más información sobre la configuración de numeraciones haz clic [aquí](http://ayuda.alegra.com/hc/es/articles/206445985-Configuraci%C3%B3n-de-la-Numeraci%C3%B3n-de-tus-comprobantes-en-Alegra). Este recurso está definido en el API como`number-template` y se puede consultar para asociar las facturas nuevas a diferentes numeraciones. Se debe tener en cuenta que en la creación de facturas, si no se envía el parámetro `numberTemplate`, la aplicación asociará la factura de venta a la numeración que se tenga como preferida siempre y cuando esta numeración esté configurada como automática (haz clic [aquí](http://ayuda.alegra.com/hc/es/articles/205737469-Configuraci%C3%B3n-de-Numeraci%C3%B3n-y-folios-de-Facturas) para saber más) y le asignará el siguiente número de facturación que corresponda. Una numeración (numberTemplate) contiene los siguientes atributos: [block:parameters] { "data": { "h-0": "Nombre", "h-1": "Tipo", "h-2": "Descripción", "h-3": "Ejemplo", "3-0": "nextInvoiceNumber", "3-1": "Integer", "3-2": "Siguiente número disponible para facturar. Este atributo solo se popula cuando la numeración esta configurada como automática.", "3-3": "150", "5-0": "invoiceText", "0-0": "id", "0-1": "Integer", "0-2": "Identificador único que representa una numeración específica. La aplicación lo asigna automáticamente.", "0-3": "1", "1-2": "Nombre con el cual está identificada la numeración.", "2-2": "Prefijo asociado a la numeración. Las facturas creadas con esta numeración se les asignará automáticamente el prefijo indicado.", "1-0": "name", "2-0": "prefix", "2-3": "AL-", "2-1": "String", "1-1": "String", "5-2": "Texto de la numeración. En versión Alegra Colombia este atributo equivale a la resolución de facturación de la factura de venta.", "5-3": "Resolución de la DIAN # 45112", "6-0": "isDefault", "6-2": "Indica si la numeración es la preferida. Sólo puede existir una numeración como preferida.", "5-1": "String", "6-1": "Boolean", "6-3": "true", "7-0": "status", "7-2": "Estado de la numeración. Puede ser active o inactive. Las numeraciones inactivas no pueden ser utilizadas en la creación de facturas de venta.", "7-3": "active", "8-0": "autoincrement", "8-1": "Boolean", "8-2": "Indica si la numeración incrementa automáticamente o se debe indicar el número de la factura.", "8-3": "true", "1-3": "Almacén Oriente", "4-0": "maxInvoiceNumber", "4-1": "Integer", "4-2": "Número final para facturar.\nEste atributo solo se popula cuando la numeración esta configurada como automática.", "4-3": "300", "9-0": "isElectronic", "9-1": "Boolean", "9-2": "Indica si la numeración es electrónica.", "9-3": "true", "10-0": "documentType", "10-1": "String", "10-2": "Indica el tipo de documento de la numeración, los valores posibles son: \n\nGeneral:\n- \"invoice\" (Factura de venta)\n\nRepublica Dominicana:\n- \"transactonIn\" (Recibo de caja)\n- \"transactionOut\" (Comprobante de egreso)\n- \"creditNote\" (Nota crédito)\n- \"debitNote\" (Nota débito)\n- \"remission\" (Remisión)\n- \"purchaseOrder\" (Orden de compra)\n- \"estimate\" (Cotización)\n\n\n\nPerú:\n- \"invoice\" (Factura de venta)\n- \"saleTicket\" (Boleta de venta)\n\n\nColombia:\n- \"invoice\" (Factura de venta)\n- \"saleTicket\" (Documento equivalente P.O.S.)\n- \"supportDocument\" (Documento soporte)", "10-3": "invoice", "11-0": "branchOffice (Republica Dominicana)", "11-1": "String", "11-2": "Indica la sucursal asociada a la numeración.\n\nEste campo es exclusivo para numeraciones de facturas (invoice) y notas crédito (creditNote).", "11-3": "Principal", "13-0": "startDate", "13-1": "String. Formato yyyy-MM-dd", "13-2": "Para la versión de Republica Dominicana y Colombia.\n\nFecha de inicio de la resolución que autoriza la numeración.\n\nEste campo es exclusivo para numeraciones de facturas (invoice).", "13-3": "2018-02-02", "14-0": "endDate", "14-1": "String. Formato yyyy-MM-dd", "14-2": "Para la versión de Republica Dominicana y Colombia.\n\nFecha final de la resolución que autoriza la numeración.\n\nEste campo es exclusivo para numeraciones de facturas (invoice).", "14-3": "2018-02-03", "15-0": "resolutionNumber (Colombia)", "15-1": "Integer", "15-2": "Para la versión de Colombia.\n\nIndica el número de resolución que autoriza la numeración.", "16-0": "subDocumentType", "16-1": "String", "16-2": "Para la versión de Chile, Costa Rica, Argentina y Republica Dominicana.\n\nActualmente se usa para invoice (actualmente factura de venta y boletas para Chile, para Costa Rica facutras de venta, para Argentina factura de venta, nota crédito, nota débito y presupuesto y para Rep. Dominicana en factura de venta, nota crédito, nota débito, pagos y gastos) . Indica un tipo de factura, por ejemplo: factura exenta. **Para modificar el tipo de factura a factura de venta, se debe enviar el parámetro vació (\"\") o si se envía un valor inexistente, se tomará como factura de venta**.\n\nConsulta el listado de valores para subDocumentType en [Chile](https://developer.alegra.com/docs/chile), [Costa Rica](https://developer.alegra.com/docs/costa-rica), [Argentina](https://developer.alegra.com/docs/argentina) y [República Dominicana (https://developer.alegra.com/docs/república-dominicana)", "16-3": "EXEMPT_INVOICE", "12-0": "branchOfficeCode (Panamá)", "12-1": "String", "12-2": "Indica el código de sucursal asociado a la numeración.\n\nEste campo es exclusivo para numeraciones electrónicas de facturas (invoice) y notas crédito (creditNote).", "12-3": "0001" }, "cols": 4, "rows": 17 } [/block] [block:callout] { "type": "info", "title": "Versión Alegra Perú", "body": "Para Perú, si la numeración es electrónica, el atributo \"prefix\" es obligatorio y debe cumplir con las siguientes reglas.\n\n * Longitud de 4 caracteres.\n * Iniciar con la letra \"F\" en mayúscula." } [/block]