{"_id":"56b224cd2d9646170059921a","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"},"parentDoc":null,"user":"56abd213d4432d1900eed227","project":"56abd2434e4b730d009eb10a","category":{"_id":"56b4b37327d9c00d005d6bc4","project":"56abd2434e4b730d009eb10a","pages":[],"version":"56abd2434e4b730d009eb10d","__v":0,"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2016-02-05T14:36:35.335Z","from_sync":false,"order":5,"slug":"numeración-de-facturación","title":"Numeración de facturación"},"__v":11,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-02-03T16:03:25.714Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":"/number-templates/{id}"},"isReference":true,"order":0,"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 (Perú)\",\n    \"9-1\": \"Boolean\",\n    \"9-2\": \"Indica si la numeración es electrónica.\",\n    \"9-3\": \"true\"\n  },\n  \"cols\": 4,\n  \"rows\": 10\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]","excerpt":"Endpoint /number-templates","slug":"numeración-de-facturación","type":"basic","title":"Descripción general"}

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 (Perú)", "9-1": "Boolean", "9-2": "Indica si la numeración es electrónica.", "9-3": "true" }, "cols": 4, "rows": 10 } [/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]