{"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 y Argentina.\\n\\nActualmente se usa para invoice (actualmente factura de venta y boletas para Chile, para Costa Rica facutras de venta y para Argentina factura de venta, nota crédito, nota debito y presupuesto) . 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) y [Argentina](https://developer.alegra.com/docs/argentina)\",\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}
Descripción general
Endpoint /number-templates