El total de la organización más el desglose por CUIT.
La unidad es el comprobante autorizado por ARCA. Un rechazo no cuenta. Las consultas al padrón, la constatación de CAE y los PDF se miden pero no consumen cuota, así que aparecen en total y no en billable.
cuitActivos son los contribuyentes que emitieron al menos un comprobante en el período: se derivan de los eventos, no se aprovisionan, así que un contribuyente dormido no cuenta.
La cuota es blanda: excederla no bloquea ninguna emisión. Cuando se excede, excedente dice por cuánto y excedenteUnitarioArs a qué precio se factura.
Scope de API key:invoice:read. Una key sin ese scope recibe 403 API_KEY_INSUFFICIENT_SCOPE, aunque el rol de quien la creó lo permita: el permiso efectivo es la intersección de los dos.
GET
/
v1
/
consumo
Consumo del período
curl --request GET \
--url https://api.emissa.com.ar/v1/consumo \
--header 'X-API-Key: <api-key>'
El producto que origina el pedido (inmos, por ejemplo). Opcional, sólo con API key. Formato ^[a-z0-9-]{1,32}$; otro valor da 400 INVALID_INPUT. Queda en el comprobante, en el consumo y en el registro de pedidos.
Con una key sin producto es sólo atribución: no autoriza ni restringe nada. Con una key atada a un producto el pedido se etiqueta con el de la key aunque no mandes la cabecera, y si mandás otro valor la respuesta es 403 API_KEY_PRODUCTO_DISTINTO.
Sólo lo que originó este producto (X-Emissa-Producto). Acota el desglose por CUIT (taxpayers) y por producto (porProducto). organizationno cambia: la cuota es de toda la organización, venga de donde venga.
Maximum string length: 32
Pattern: ^[a-z0-9-]{1,32}$
Example:
"inmos"
Response
El consumo del periodo, con el desglose por CUIT. La cuota es blanda: el excedente se factura, no bloquea la emision.
Desglose por producto (X-Emissa-Producto): de mayor a menor, con producto: null al final para lo que no llevó etiqueta. Con una API key viene acotado a los contribuyentes que esa key alcanza. Sale de los eventos de consumo, así que puede no sumar organization.usada si hubo eventos que no cuentan para la cuota (total).
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Emissa","description":"Infraestructura de emisión de comprobantes electrónicos ARCA.","colors":{"primary":"#0c0cc8","light":"#f6f6f9","dark":"#0c0cc8"},"logo":{"light":"https://mintcdn.com/emissa/54zD7qivv8TCTuUU/images/marca/navigation-positive-on-white.svg?fit=max\u0026auto=format\u0026n=54zD7qivv8TCTuUU\u0026q=85\u0026s=31720f0a4e045e64fd37cff5a02df0d4","dark":"https://mintcdn.com/emissa/54zD7qivv8TCTuUU/images/marca/navigation-inverse-on-blue.svg?fit=max\u0026auto=format\u0026n=54zD7qivv8TCTuUU\u0026q=85\u0026s=94c73488d90524c9d870ce2e88cc0f09","href":"https://www.emissa.com.ar"},"favicon":"https://mintcdn.com/emissa/54zD7qivv8TCTuUU/images/marca/isotipo-small-positive.svg?fit=max\u0026auto=format\u0026n=54zD7qivv8TCTuUU\u0026q=85\u0026s=a94dd93de76510c2799744fe81825e31","appearance":{"default":"light","strict":false},"navbar":{"links":[{"href":"https://www.emissa.com.ar/panel","label":"Panel"}],"primary":{"type":"button","label":"Empezar gratis","href":"https://www.emissa.com.ar/register"}},"footer":{"socials":{"website":"https://www.emissa.com.ar"}},"search":{"prompt":"Buscar en la documentación…"},"contextual":{"options":["copy","view"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"emissa","hasAudioNarration":false,"actualSubdomain":"emissa","customDomains":["www.emissa.com.ar"],"gitSource":{"type":"github","owner":"defineit-ar","repo":"emissa","deployBranch":"master","contentDirectory":"apps/web/src/content","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ad7da6b81a20d9693c12bb3","collectionId":"6fe54883-a619-4bdc-8c5e-d410543096e4","liveDeploymentHistoryId":"6ad7da6b81a20d9693c12bb3","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ad7da6b81a20d9693c12bb3","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Referencia de la API","count":20},{"language":"default","tag":"Guías","count":14},{"language":"default","tag":"Comprobantes","count":8},{"language":"default","tag":"Contribuyentes","count":7},{"language":"default","tag":"Empezar","count":5},{"language":"default","tag":"Integrar","count":4},{"language":"default","tag":"Credenciales ARCA","count":3},{"language":"default","tag":"Planes y cobro","count":2},{"language":"default","tag":"Referencia de consulta","count":2},{"language":"default","tag":"Usar el panel","count":1}],"searchSettings":{"showContentSnippets":true,"isFiltersEnabled":true}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":true}},"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#navbar>div,div:has(>#sidebar){max-width:none}#content,#header{max-width:1100px}.dgm{margin:1.75rem 0;width:100%}.dgm img{border-radius:14px;height:auto;width:100%}.dgm-cap{color:#5a6072;font-size:.8125rem;line-height:1.45;margin:.75rem 0 0;text-align:center}.dgm img.dgm-claro{display:block}.dark .dgm img.dgm-claro,.dgm img.dgm-oscuro{display:none}.dark .dgm-cap{color:#9aa0b0}.dark .dgm img.dgm-oscuro{display:block}"}],"page":{"pagePath":"api-reference/consumo/consumo-del-período","slug":"/api-reference/consumo/consumo-del-período","pageMetadata":{"title":"Consumo del período","description":"El total de la organización más el desglose por CUIT.\n\n**La unidad es el comprobante autorizado por ARCA.** Un rechazo no cuenta. Las consultas al padrón, la constatación de CAE y los PDF se miden pero no consumen cuota, así que aparecen en `total` y no en `billable`.\n\n`cuitActivos` son los contribuyentes que emitieron al menos un comprobante en el período: **se derivan de los eventos, no se aprovisionan**, así que un contribuyente dormido no cuenta.\n\n**La cuota es blanda**: excederla no bloquea ninguna emisión. Cuando se excede, `excedente` dice por cuánto y `excedenteUnitarioArs` a qué precio se factura.\n\n**Scope de API key:** `invoice:read`. Una key sin ese scope recibe `403 API_KEY_INSUFFICIENT_SCOPE`, aunque el rol de quien la creó lo permita: el permiso efectivo es la **intersección** de los dos.","deprecated":null,"version":null,"openapi":"https://api.emissa.com.ar/openapi.json get /v1/consumo","href":"/api-reference/consumo/consumo-del-período","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"El total de la organización más el desglose por CUIT.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"La unidad es el comprobante autorizado por ARCA.\"\n }), \" Un rechazo no cuenta. Las consultas al padrón, la constatación de CAE y los PDF se miden pero no consumen cuota, así que aparecen en \", _jsx(_components.code, {\n children: \"total\"\n }), \" y no en \", _jsx(_components.code, {\n children: \"billable\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.code, {\n children: \"cuitActivos\"\n }), \" son los contribuyentes que emitieron al menos un comprobante en el período: \", _jsx(_components.strong, {\n children: \"se derivan de los eventos, no se aprovisionan\"\n }), \", así que un contribuyente dormido no cuenta.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"La cuota es blanda\"\n }), \": excederla no bloquea ninguna emisión. Cuando se excede, \", _jsx(_components.code, {\n children: \"excedente\"\n }), \" dice por cuánto y \", _jsx(_components.code, {\n children: \"excedenteUnitarioArs\"\n }), \" a qué precio se factura.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Scope de API key:\"\n }), \" \", _jsx(_components.code, {\n children: \"invoice:read\"\n }), \". Una key sin ese scope recibe \", _jsx(_components.code, {\n children: \"403 API_KEY_INSUFFICIENT_SCOPE\"\n }), \", aunque el rol de quien la creó lo permita: el permiso efectivo es la \", _jsx(_components.strong, {\n children: \"intersección\"\n }), \" de los dos.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Consumo del período","description":"El total de la organización más el desglose por CUIT.\n\n**La unidad es el comprobante autorizado por ARCA.** Un rechazo no cuenta. Las consultas al padrón, la constatación de CAE y los PDF se miden pero no consumen cuota, así que aparecen en `total` y no en `billable`.\n\n`cuitActivos` son los contribuyentes que emitieron al menos un comprobante en el período: **se derivan de los eventos, no se aprovisionan**, así que un contribuyente dormido no cuenta.\n\n**La cuota es blanda**: excederla no bloquea ninguna emisión. Cuando se excede, `excedente` dice por cuánto y `excedenteUnitarioArs` a qué precio se factura.\n\n**Scope de API key:** `invoice:read`. Una key sin ese scope recibe `403 API_KEY_INSUFFICIENT_SCOPE`, aunque el rol de quien la creó lo permita: el permiso efectivo es la **intersección** de los dos.","deprecated":null,"version":null,"openapi":"https://api.emissa.com.ar/openapi.json get /v1/consumo","href":"/api-reference/consumo/consumo-del-período","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"El total de la organización más el desglose por CUIT.\n\n**La unidad es el comprobante autorizado por ARCA.** Un rechazo no cuenta. Las consultas al padrón, la constatación de CAE y los PDF se miden pero no consumen cuota, así que aparecen en `total` y no en `billable`.\n\n`cuitActivos` son los contribuyentes que emitieron al menos un comprobante en el período: **se derivan de los eventos, no se aprovisionan**, así que un contribuyente dormido no cuenta.\n\n**La cuota es blanda**: excederla no bloquea ninguna emisión. Cuando se excede, `excedente` dice por cuánto y `excedenteUnitarioArs` a qué precio se factura.\n\n**Scope de API key:** `invoice:read`. Una key sin ese scope recibe `403 API_KEY_INSUFFICIENT_SCOPE`, aunque el rol de quien la creó lo permita: el permiso efectivo es la **intersección** de los dos.","operationId":"ConsumoController_consumo","parameters":["3b9e8a47-fd12-4e19-9299-a74bc9e0a7a6","520b908e-95a6-44d7-a577-d75d7407c468","9ae14f50-ef4e-41f9-8a92-5ed735968bf1","53b5e5d3-a586-4397-bbd5-e6ce35deed05"],"responses":{"200":"5b423ac6-e2fd-4a6e-966d-4b5483dc7022","400":"ed33ce2a-1831-4849-ab16-097e8f6340f1","401":"c376cc30-4416-4cd0-9f6e-c2c83b6a31de","403":"3624a929-f8d9-4b76-b056-8253539ba713","429":"01fd5c1b-aa17-4463-b1a1-a082db6fff9d","500":"52be8b46-2b5f-40ec-87a9-e17309faded9"},"security":["a2cdf807-94c2-4c5f-ab6a-e7e1f52b074d","6af7c2f9-a2e5-4d2a-ac6e-c065e158396d"],"summary":"Consumo del período","tags":["Consumo"],"x-scopes":["invoice:read"],"method":"get","type":"path","servers":["4c3ac454-1611-42e6-9972-fdce75c66d95","59c0321e-fc8e-4fd2-8484-7481e01419e1"],"path":"/v1/consumo","baseUrlOptions":["https://api.emissa.com.ar","http://localhost:3001"],"title":"Consumo del período","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"3b9e8a47-fd12-4e19-9299-a74bc9e0a7a6":{"name":"periodo","required":false,"in":"query","description":"`YYYY-MM` en zona argentina. Por defecto, el período en curso.","schema":{"example":"2026-07","type":"string","isRequired":false,"description":"`YYYY-MM` en zona argentina. Por defecto, el período en curso.","uniqueKey":"","typeLabel":"string"}},"520b908e-95a6-44d7-a577-d75d7407c468":{"name":"contribuyente","required":false,"in":"query","description":"Id de un contribuyente, para ver sólo el suyo. Sin esto viene el total de la organización con el desglose por CUIT.","schema":{"type":"string","isRequired":false,"description":"Id de un contribuyente, para ver sólo el suyo. Sin esto viene el total de la organización con el desglose por CUIT.","uniqueKey":"","typeLabel":"string"}},"9ae14f50-ef4e-41f9-8a92-5ed735968bf1":{"name":"producto","required":false,"in":"query","description":"Sólo lo que originó este producto (`X-Emissa-Producto`). Acota el desglose por CUIT (`taxpayers`) y por producto (`porProducto`). `organization` **no cambia**: la cuota es de toda la organización, venga de donde venga.","schema":{"maxLength":32,"pattern":"^[a-z0-9-]{1,32}$","example":"inmos","type":"string","isRequired":false,"description":"Sólo lo que originó este producto (`X-Emissa-Producto`). Acota el desglose por CUIT (`taxpayers`) y por producto (`porProducto`). `organization` **no cambia**: la cuota es de toda la organización, venga de donde venga.","uniqueKey":"","typeLabel":"string"}},"53b5e5d3-a586-4397-bbd5-e6ce35deed05":{"name":"X-Emissa-Producto","in":"header","description":"El producto que origina el pedido (`inmos`, por ejemplo). Opcional, sólo con API key. Formato `^[a-z0-9-]{1,32}$`; otro valor da `400 INVALID_INPUT`. Queda en el comprobante, en el consumo y en el registro de pedidos.\n\nCon una key **sin** producto es sólo atribución: no autoriza ni restringe nada. Con una key **atada a un producto** el pedido se etiqueta con el de la key aunque no mandes la cabecera, y si mandás otro valor la respuesta es `403 API_KEY_PRODUCTO_DISTINTO`.","required":false,"schema":{"type":"string","pattern":"^[a-z0-9-]{1,32}$","example":"inmos","isRequired":false,"description":"El producto que origina el pedido (`inmos`, por ejemplo). Opcional, sólo con API key. Formato `^[a-z0-9-]{1,32}$`; otro valor da `400 INVALID_INPUT`. Queda en el comprobante, en el consumo y en el registro de pedidos.\n\nCon una key **sin** producto es sólo atribución: no autoriza ni restringe nada. Con una key **atada a un producto** el pedido se etiqueta con el de la key aunque no mandes la cabecera, y si mandás otro valor la respuesta es `403 API_KEY_PRODUCTO_DISTINTO`.","uniqueKey":"","typeLabel":"string"}}},"responses":{"5b423ac6-e2fd-4a6e-966d-4b5483dc7022":{"description":"El consumo del periodo, con el desglose por CUIT. **La cuota es blanda**: el excedente se factura, no bloquea la emision.","headers":{"X-Request-Id":{"description":"Identificador del pedido. Va en TODA respuesta. Si lo mandás en el pedido y respeta `[A-Za-z0-9._:-]{1,128}`, se te devuelve el mismo; si no, se genera uno. Es lo que hay que citar en un ticket.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"period":{"type":"string","example":"2026-07","description":"El período, `YYYY-MM`.","isRequired":true,"uniqueKey":"period","typeLabel":"string"},"plan":{"type":"string","example":"STARTER","description":"El plan contratado, que determina el límite y el precio del excedente.","isRequired":true,"uniqueKey":"plan","typeLabel":"string"},"organization":{"type":"object","description":"El total de la organización, sumando todos sus CUIT.","required":["limite","usada","restante","excedente","excedenteUnitarioArs","cuitActivos","reinicio"],"properties":{"limite":{"oneOf":[{"type":"number","example":500,"description":"Comprobantes incluidos en el período. **`null` significa sin límite**, no cero.","isRequired":true,"uniqueKey":"organization.limite.oneOf.0","typeLabel":"number"},{"type":"null","example":500,"description":"Comprobantes incluidos en el período. **`null` significa sin límite**, no cero.","isRequired":true,"uniqueKey":"organization.limite.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"organization.limite","typeLabel":"number | null"},"usada":{"type":"number","example":128,"description":"Comprobantes facturables emitidos.","isRequired":true,"uniqueKey":"organization.usada","typeLabel":"number"},"restante":{"oneOf":[{"type":"number","example":372,"description":"`null` cuando `limite` es `null`.","isRequired":true,"uniqueKey":"organization.restante.oneOf.0","typeLabel":"number"},{"type":"null","example":372,"description":"`null` cuando `limite` es `null`.","isRequired":true,"uniqueKey":"organization.restante.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"organization.restante","typeLabel":"number | null"},"excedente":{"type":"number","example":0,"description":"Cuánto se pasó del límite. **La cuota es blanda: el excedente se factura, no bloquea la emisión.**","isRequired":true,"uniqueKey":"organization.excedente","typeLabel":"number"},"excedenteUnitarioArs":{"oneOf":[{"type":"number","example":0.012,"description":"Precio por comprobante excedente, en dólares.","isRequired":true,"uniqueKey":"organization.excedenteUnitarioArs.oneOf.0","typeLabel":"number"},{"type":"null","example":0.012,"description":"Precio por comprobante excedente, en dólares.","isRequired":true,"uniqueKey":"organization.excedenteUnitarioArs.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"organization.excedenteUnitarioArs","typeLabel":"number | null"},"cuitActivos":{"type":"number","example":2,"description":"Cuántos CUIT emitieron al menos un comprobante en el período. En los planes por CUIT es lo que determina el límite.","isRequired":true,"uniqueKey":"organization.cuitActivos","typeLabel":"number"},"reinicio":{"type":"string","example":"2026-08-01","description":"Cuándo arranca el período siguiente y el contador vuelve a cero.","isRequired":true,"uniqueKey":"organization.reinicio","typeLabel":"string"}},"isRequired":true,"uniqueKey":"organization","typeLabel":"object"},"taxpayers":{"description":"Desglose por CUIT. **Con una API key viene acotado** a los contribuyentes que esa key alcanza.","type":"array","items":{"type":"object","properties":{"taxpayerId":{"type":"string","example":"cms5182yf00gxurgsa7fzew8p","description":"De qué contribuyente es esta fila.","isRequired":true,"uniqueKey":"taxpayers.items.[INDEX].taxpayerId","typeLabel":"string"},"cuit":{"type":"string","example":"20437136697","description":"Su CUIT, para no tener que cruzarlo contra otra consulta.","isRequired":true,"uniqueKey":"taxpayers.items.[INDEX].cuit","typeLabel":"string"},"billable":{"type":"number","example":120,"description":"Los que cuentan para la cuota: autorizados por ARCA.","isRequired":true,"uniqueKey":"taxpayers.items.[INDEX].billable","typeLabel":"number"},"total":{"type":"number","example":131,"description":"Todos los intentos, incluidos los rechazados y los que fallaron. `total - billable` es lo que se intentó y no se cobró.","isRequired":true,"uniqueKey":"taxpayers.items.[INDEX].total","typeLabel":"number"}},"required":["taxpayerId","cuit","billable","total"],"uniqueKey":"taxpayers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"taxpayers","typeLabel":"object[]"},"porProducto":{"description":"Desglose por producto (`X-Emissa-Producto`): de mayor a menor, con `producto: null` al final para lo que no llevó etiqueta. Con una API key viene acotado a los contribuyentes que esa key alcanza. Sale de los eventos de consumo, así que puede no sumar `organization.usada` si hubo eventos que no cuentan para la cuota (`total`).","type":"array","items":{"type":"object","properties":{"producto":{"oneOf":[{"type":"string","example":"inmos","description":"El valor de `X-Emissa-Producto`. **`null` agrupa lo que no llevó la cabecera**: lo del panel, lo anterior a la etiqueta y lo de quien no la manda.","isRequired":true,"uniqueKey":"porProducto.items.[INDEX].producto.oneOf.0","typeLabel":"string"},{"type":"null","example":"inmos","description":"El valor de `X-Emissa-Producto`. **`null` agrupa lo que no llevó la cabecera**: lo del panel, lo anterior a la etiqueta y lo de quien no la manda.","isRequired":true,"uniqueKey":"porProducto.items.[INDEX].producto.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"porProducto.items.[INDEX].producto","typeLabel":"string | null"},"billable":{"type":"number","example":120,"description":"Los que cuentan para la cuota: autorizados por ARCA.","isRequired":true,"uniqueKey":"porProducto.items.[INDEX].billable","typeLabel":"number"},"total":{"type":"number","example":131,"description":"Todos los intentos medidos, incluidos los rechazados. `total - billable` es lo que se intentó y no se cobró.","isRequired":true,"uniqueKey":"porProducto.items.[INDEX].total","typeLabel":"number"}},"required":["producto","billable","total"],"uniqueKey":"porProducto.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"porProducto","typeLabel":"object[]"}},"required":["period","plan","organization","taxpayers","porProducto"],"uniqueKey":"","typeLabel":"object"},"example":{"period":"2026-08","plan":"SANDBOX","organization":{"limite":50,"usada":0,"restante":50,"excedente":0,"excedenteUnitarioArs":null,"cuitActivos":0,"reinicio":"2026-09-01T03:00:00.000Z"},"taxpayers":[{"taxpayerId":"cmt42x6jb000curi4sz1gyeij","cuit":"20000000001","billable":0,"total":1}],"porProducto":[{"producto":null,"billable":0,"total":1}]},"examples":{"Example":{"title":"Example","value":{"period":"2026-08","plan":"SANDBOX","organization":{"limite":50,"usada":0,"restante":50,"excedente":0,"excedenteUnitarioArs":null,"cuitActivos":0,"reinicio":"2026-09-01T03:00:00.000Z"},"taxpayers":[{"taxpayerId":"cmt42x6jb000curi4sz1gyeij","cuit":"20000000001","billable":0,"total":1}],"porProducto":[{"producto":null,"billable":0,"total":1}]}}},"exampleType":"examples"}},"exampleType":"examples"},"ed33ce2a-1831-4849-ab16-097e8f6340f1":{"description":"Pedido mal formado o inválido.\n\n`errorCode`: `INVALID_INPUT`","content":{"application/json":{"schema":{"type":"object","required":["statusCode","errorCode","message","timestamp","path"],"properties":{"statusCode":{"type":"number","example":401,"description":"El mismo código HTTP de la respuesta. Va repetido en el cuerpo para que un cliente que sólo loguea el JSON no pierda el dato.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"errorCode":{"type":"string","description":"Siempre una entrada del catálogo de errores. Es el campo por el que se ramifica.","enum":["INVALID_INPUT"],"example":"UNAUTHORIZED","isRequired":true,"uniqueKey":"errorCode","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"No autorizado","description":"**Siempre un string**, nunca un arreglo.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","example":"2026-07-26T18:30:00.000Z","description":"Cuándo falló, en UTC. Sirve para ubicarlo en los logs.","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string"},"path":{"type":"string","example":"/v1/invoices/authorize","description":"La ruta que se pidió, sin el host ni la query.","isRequired":true,"uniqueKey":"path","typeLabel":"string"},"details":{"oneOf":[{"type":"string","description":"Detalle adicional. Lo contractual viaja siempre; lo de diagnóstico **no viaja en producción**. No ramifiques por este campo.","uniqueKey":"details.oneOf.0","typeLabel":"string"},{"type":"object","description":"Detalle adicional. Lo contractual viaja siempre; lo de diagnóstico **no viaja en producción**. No ramifiques por este campo.","additionalProperties":true,"uniqueKey":"details.oneOf.1","typeLabel":"object"}],"uniqueKey":"details","typeLabel":"string | object"},"retryable":{"type":"boolean","example":false,"description":"**¿Tiene sentido reintentar?** Si viene, le gana a cualquier heurística basada en el status.\n\nExiste porque el status no alcanza: `ARCA_TICKET_ALREADY_ISSUED` es un 409 que **se resuelve esperando**, y `ARCA_COMPUTER_NOT_AUTHORIZED` es un 502 que **no se arregla nunca esperando** — hay que autorizar el certificado en ARCA. Un cliente que ramifique sólo por 4xx/5xx acierta al revés en los dos.\n\n**Ausente significa \"no lo sabemos\"**, y es distinto de `false`: ahí corresponde la heurística de siempre. Sólo se declara donde la respuesta es certera.","uniqueKey":"retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"number","example":43200,"description":"Cuántos segundos esperar antes de reintentar. **Sólo cuando el número es real** —el vencimiento de un ticket, la ventana de un límite—, nunca una estimación.\n\nEl 429 y el bloqueo del segundo factor ya lo mandaban como `details.reintentarEnSegundos`, en castellano y anidado. Sigue ahí para no romper a nadie, y ahora **también arriba**, con el nombre del resto del sobre.","uniqueKey":"retryAfterSeconds","typeLabel":"number"},"requestId":{"type":"string","example":"0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e","description":"El mismo valor de la cabecera `X-Request-Id`. Es lo que hay que pegar en un ticket.","uniqueKey":"requestId","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":401,"errorCode":"UNAUTHORIZED","message":"No autorizado","timestamp":"2026-07-26T18:30:00.000Z","path":"/v1/invoices/authorize","details":"\u003cstring>","retryable":false,"retryAfterSeconds":43200,"requestId":"0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"}}},"exampleType":"generated"}},"headers":{"X-Request-Id":{"description":"Identificador del pedido. Va en TODA respuesta. Si lo mandás en el pedido y respeta `[A-Za-z0-9._:-]{1,128}`, se te devuelve el mismo; si no, se genera uno. Es lo que hay que citar en un ticket.","schema":{"type":"string"}},"X-Emissa-Mode":{"description":"`test` o `live`. **Va en toda respuesta autenticada con API key**, y es la forma más barata de verificar que no estás emitiendo contra el ambiente equivocado. No aparece cuando se entra con sesión de panel: ahí el ambiente lo decide cada contribuyente, no la credencial.","schema":{"type":"string","enum":["test","live"]}}},"exampleType":"generated"},"c376cc30-4416-4cd0-9f6e-c2c83b6a31de":{"description":"Falta la credencial o no es válida.\n\n`errorCode`: `UNAUTHORIZED`, `INVALID_API_KEY`, `API_KEY_WRONG_HEADER`","content":{"application/json":{"schema":{"type":"object","required":["statusCode","errorCode","message","timestamp","path"],"properties":{"statusCode":{"type":"number","example":401,"description":"El mismo código HTTP de la respuesta. Va repetido en el cuerpo para que un cliente que sólo loguea el JSON no pierda el dato.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"errorCode":{"type":"string","description":"Siempre una entrada del catálogo de errores. Es el campo por el que se ramifica.","enum":["UNAUTHORIZED","INVALID_API_KEY","API_KEY_WRONG_HEADER"],"example":"UNAUTHORIZED","isRequired":true,"uniqueKey":"errorCode","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"No autorizado","description":"**Siempre un string**, nunca un arreglo.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","example":"2026-07-26T18:30:00.000Z","description":"Cuándo falló, en UTC. Sirve para ubicarlo en los logs.","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string"},"path":{"type":"string","example":"/v1/invoices/authorize","description":"La ruta que se pidió, sin el host ni la query.","isRequired":true,"uniqueKey":"path","typeLabel":"string"},"details":{"oneOf":[{"type":"string","description":"Detalle adicional. Lo contractual viaja siempre; lo de diagnóstico **no viaja en producción**. No ramifiques por este campo.","uniqueKey":"details.oneOf.0","typeLabel":"string"},{"type":"object","description":"Detalle adicional. Lo contractual viaja siempre; lo de diagnóstico **no viaja en producción**. No ramifiques por este campo.","additionalProperties":true,"uniqueKey":"details.oneOf.1","typeLabel":"object"}],"uniqueKey":"details","typeLabel":"string | object"},"retryable":{"type":"boolean","example":false,"description":"**¿Tiene sentido reintentar?** Si viene, le gana a cualquier heurística basada en el status.\n\nExiste porque el status no alcanza: `ARCA_TICKET_ALREADY_ISSUED` es un 409 que **se resuelve esperando**, y `ARCA_COMPUTER_NOT_AUTHORIZED` es un 502 que **no se arregla nunca esperando** — hay que autorizar el certificado en ARCA. Un cliente que ramifique sólo por 4xx/5xx acierta al revés en los dos.\n\n**Ausente significa \"no lo sabemos\"**, y es distinto de `false`: ahí corresponde la heurística de siempre. Sólo se declara donde la respuesta es certera.","uniqueKey":"retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"number","example":43200,"description":"Cuántos segundos esperar antes de reintentar. **Sólo cuando el número es real** —el vencimiento de un ticket, la ventana de un límite—, nunca una estimación.\n\nEl 429 y el bloqueo del segundo factor ya lo mandaban como `details.reintentarEnSegundos`, en castellano y anidado. Sigue ahí para no romper a nadie, y ahora **también arriba**, con el nombre del resto del sobre.","uniqueKey":"retryAfterSeconds","typeLabel":"number"},"requestId":{"type":"string","example":"0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e","description":"El mismo valor de la cabecera `X-Request-Id`. Es lo que hay que pegar en un ticket.","uniqueKey":"requestId","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":401,"errorCode":"UNAUTHORIZED","message":"No autorizado","timestamp":"2026-07-26T18:30:00.000Z","path":"/v1/invoices/authorize","details":"\u003cstring>","retryable":false,"retryAfterSeconds":43200,"requestId":"0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"}}},"exampleType":"generated"}},"headers":{"X-Request-Id":{"description":"Identificador del pedido. Va en TODA respuesta. Si lo mandás en el pedido y respeta `[A-Za-z0-9._:-]{1,128}`, se te devuelve el mismo; si no, se genera uno. Es lo que hay que citar en un ticket.","schema":{"type":"string"}},"X-Emissa-Mode":{"description":"`test` o `live`. **Va en toda respuesta autenticada con API key**, y es la forma más barata de verificar que no estás emitiendo contra el ambiente equivocado. No aparece cuando se entra con sesión de panel: ahí el ambiente lo decide cada contribuyente, no la credencial.","schema":{"type":"string","enum":["test","live"]}}},"exampleType":"generated"},"3624a929-f8d9-4b76-b056-8253539ba713":{"description":"La credencial es válida pero no alcanza. Con API key, también: el **modo de la key no coincide con el ambiente del contribuyente**. Una `emi_test_` contra un contribuyente de `PRODUCCION` nunca emite.\n\n`errorCode`: `FORBIDDEN`, `API_KEY_INSUFFICIENT_PERMISSIONS`, `API_KEY_INSUFFICIENT_SCOPE`, `API_KEY_WRONG_MODE`","content":{"application/json":{"schema":{"type":"object","required":["statusCode","errorCode","message","timestamp","path"],"properties":{"statusCode":{"type":"number","example":401,"description":"El mismo código HTTP de la respuesta. Va repetido en el cuerpo para que un cliente que sólo loguea el JSON no pierda el dato.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"errorCode":{"type":"string","description":"Siempre una entrada del catálogo de errores. Es el campo por el que se ramifica.","enum":["FORBIDDEN","API_KEY_INSUFFICIENT_PERMISSIONS","API_KEY_INSUFFICIENT_SCOPE","API_KEY_WRONG_MODE"],"example":"UNAUTHORIZED","isRequired":true,"uniqueKey":"errorCode","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"No autorizado","description":"**Siempre un string**, nunca un arreglo.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","example":"2026-07-26T18:30:00.000Z","description":"Cuándo falló, en UTC. Sirve para ubicarlo en los logs.","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string"},"path":{"type":"string","example":"/v1/invoices/authorize","description":"La ruta que se pidió, sin el host ni la query.","isRequired":true,"uniqueKey":"path","typeLabel":"string"},"details":{"oneOf":[{"type":"string","description":"Detalle adicional. Lo contractual viaja siempre; lo de diagnóstico **no viaja en producción**. No ramifiques por este campo.","uniqueKey":"details.oneOf.0","typeLabel":"string"},{"type":"object","description":"Detalle adicional. Lo contractual viaja siempre; lo de diagnóstico **no viaja en producción**. No ramifiques por este campo.","additionalProperties":true,"uniqueKey":"details.oneOf.1","typeLabel":"object"}],"uniqueKey":"details","typeLabel":"string | object"},"retryable":{"type":"boolean","example":false,"description":"**¿Tiene sentido reintentar?** Si viene, le gana a cualquier heurística basada en el status.\n\nExiste porque el status no alcanza: `ARCA_TICKET_ALREADY_ISSUED` es un 409 que **se resuelve esperando**, y `ARCA_COMPUTER_NOT_AUTHORIZED` es un 502 que **no se arregla nunca esperando** — hay que autorizar el certificado en ARCA. Un cliente que ramifique sólo por 4xx/5xx acierta al revés en los dos.\n\n**Ausente significa \"no lo sabemos\"**, y es distinto de `false`: ahí corresponde la heurística de siempre. Sólo se declara donde la respuesta es certera.","uniqueKey":"retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"number","example":43200,"description":"Cuántos segundos esperar antes de reintentar. **Sólo cuando el número es real** —el vencimiento de un ticket, la ventana de un límite—, nunca una estimación.\n\nEl 429 y el bloqueo del segundo factor ya lo mandaban como `details.reintentarEnSegundos`, en castellano y anidado. Sigue ahí para no romper a nadie, y ahora **también arriba**, con el nombre del resto del sobre.","uniqueKey":"retryAfterSeconds","typeLabel":"number"},"requestId":{"type":"string","example":"0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e","description":"El mismo valor de la cabecera `X-Request-Id`. Es lo que hay que pegar en un ticket.","uniqueKey":"requestId","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":401,"errorCode":"UNAUTHORIZED","message":"No autorizado","timestamp":"2026-07-26T18:30:00.000Z","path":"/v1/invoices/authorize","details":"\u003cstring>","retryable":false,"retryAfterSeconds":43200,"requestId":"0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"}}},"exampleType":"generated"}},"headers":{"X-Request-Id":{"description":"Identificador del pedido. Va en TODA respuesta. Si lo mandás en el pedido y respeta `[A-Za-z0-9._:-]{1,128}`, se te devuelve el mismo; si no, se genera uno. Es lo que hay que citar en un ticket.","schema":{"type":"string"}},"X-Emissa-Mode":{"description":"`test` o `live`. **Va en toda respuesta autenticada con API key**, y es la forma más barata de verificar que no estás emitiendo contra el ambiente equivocado. No aparece cuando se entra con sesión de panel: ahí el ambiente lo decide cada contribuyente, no la credencial.","schema":{"type":"string","enum":["test","live"]}}},"exampleType":"generated"},"01fd5c1b-aa17-4463-b1a1-a082db6fff9d":{"description":"Se excedió el límite de peticiones. **Reintentá con backoff.**\n\n`errorCode`: `RATE_LIMIT_EXCEEDED`","content":{"application/json":{"schema":{"type":"object","required":["statusCode","errorCode","message","timestamp","path"],"properties":{"statusCode":{"type":"number","example":401,"description":"El mismo código HTTP de la respuesta. Va repetido en el cuerpo para que un cliente que sólo loguea el JSON no pierda el dato.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"errorCode":{"type":"string","description":"Siempre una entrada del catálogo de errores. Es el campo por el que se ramifica.","enum":["RATE_LIMIT_EXCEEDED"],"example":"UNAUTHORIZED","isRequired":true,"uniqueKey":"errorCode","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"No autorizado","description":"**Siempre un string**, nunca un arreglo.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","example":"2026-07-26T18:30:00.000Z","description":"Cuándo falló, en UTC. Sirve para ubicarlo en los logs.","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string"},"path":{"type":"string","example":"/v1/invoices/authorize","description":"La ruta que se pidió, sin el host ni la query.","isRequired":true,"uniqueKey":"path","typeLabel":"string"},"details":{"oneOf":[{"type":"string","description":"Detalle adicional. Lo contractual viaja siempre; lo de diagnóstico **no viaja en producción**. No ramifiques por este campo.","uniqueKey":"details.oneOf.0","typeLabel":"string"},{"type":"object","description":"Detalle adicional. Lo contractual viaja siempre; lo de diagnóstico **no viaja en producción**. No ramifiques por este campo.","additionalProperties":true,"uniqueKey":"details.oneOf.1","typeLabel":"object"}],"uniqueKey":"details","typeLabel":"string | object"},"retryable":{"type":"boolean","example":false,"description":"**¿Tiene sentido reintentar?** Si viene, le gana a cualquier heurística basada en el status.\n\nExiste porque el status no alcanza: `ARCA_TICKET_ALREADY_ISSUED` es un 409 que **se resuelve esperando**, y `ARCA_COMPUTER_NOT_AUTHORIZED` es un 502 que **no se arregla nunca esperando** — hay que autorizar el certificado en ARCA. Un cliente que ramifique sólo por 4xx/5xx acierta al revés en los dos.\n\n**Ausente significa \"no lo sabemos\"**, y es distinto de `false`: ahí corresponde la heurística de siempre. Sólo se declara donde la respuesta es certera.","uniqueKey":"retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"number","example":43200,"description":"Cuántos segundos esperar antes de reintentar. **Sólo cuando el número es real** —el vencimiento de un ticket, la ventana de un límite—, nunca una estimación.\n\nEl 429 y el bloqueo del segundo factor ya lo mandaban como `details.reintentarEnSegundos`, en castellano y anidado. Sigue ahí para no romper a nadie, y ahora **también arriba**, con el nombre del resto del sobre.","uniqueKey":"retryAfterSeconds","typeLabel":"number"},"requestId":{"type":"string","example":"0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e","description":"El mismo valor de la cabecera `X-Request-Id`. Es lo que hay que pegar en un ticket.","uniqueKey":"requestId","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":401,"errorCode":"UNAUTHORIZED","message":"No autorizado","timestamp":"2026-07-26T18:30:00.000Z","path":"/v1/invoices/authorize","details":"\u003cstring>","retryable":false,"retryAfterSeconds":43200,"requestId":"0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"}}},"exampleType":"generated"}},"headers":{"X-Request-Id":{"description":"Identificador del pedido. Va en TODA respuesta. Si lo mandás en el pedido y respeta `[A-Za-z0-9._:-]{1,128}`, se te devuelve el mismo; si no, se genera uno. Es lo que hay que citar en un ticket.","schema":{"type":"string"}},"X-Emissa-Mode":{"description":"`test` o `live`. **Va en toda respuesta autenticada con API key**, y es la forma más barata de verificar que no estás emitiendo contra el ambiente equivocado. No aparece cuando se entra con sesión de panel: ahí el ambiente lo decide cada contribuyente, no la credencial.","schema":{"type":"string","enum":["test","live"]}}},"exampleType":"generated"},"52be8b46-2b5f-40ec-87a9-e17309faded9":{"description":"Error interno. Citá el `requestId` al reportarlo.\n\n`errorCode`: `INTERNAL_ERROR`","content":{"application/json":{"schema":{"type":"object","required":["statusCode","errorCode","message","timestamp","path"],"properties":{"statusCode":{"type":"number","example":401,"description":"El mismo código HTTP de la respuesta. Va repetido en el cuerpo para que un cliente que sólo loguea el JSON no pierda el dato.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"errorCode":{"type":"string","description":"Siempre una entrada del catálogo de errores. Es el campo por el que se ramifica.","enum":["INTERNAL_ERROR"],"example":"UNAUTHORIZED","isRequired":true,"uniqueKey":"errorCode","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"No autorizado","description":"**Siempre un string**, nunca un arreglo.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","example":"2026-07-26T18:30:00.000Z","description":"Cuándo falló, en UTC. Sirve para ubicarlo en los logs.","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string"},"path":{"type":"string","example":"/v1/invoices/authorize","description":"La ruta que se pidió, sin el host ni la query.","isRequired":true,"uniqueKey":"path","typeLabel":"string"},"details":{"oneOf":[{"type":"string","description":"Detalle adicional. Lo contractual viaja siempre; lo de diagnóstico **no viaja en producción**. No ramifiques por este campo.","uniqueKey":"details.oneOf.0","typeLabel":"string"},{"type":"object","description":"Detalle adicional. Lo contractual viaja siempre; lo de diagnóstico **no viaja en producción**. No ramifiques por este campo.","additionalProperties":true,"uniqueKey":"details.oneOf.1","typeLabel":"object"}],"uniqueKey":"details","typeLabel":"string | object"},"retryable":{"type":"boolean","example":false,"description":"**¿Tiene sentido reintentar?** Si viene, le gana a cualquier heurística basada en el status.\n\nExiste porque el status no alcanza: `ARCA_TICKET_ALREADY_ISSUED` es un 409 que **se resuelve esperando**, y `ARCA_COMPUTER_NOT_AUTHORIZED` es un 502 que **no se arregla nunca esperando** — hay que autorizar el certificado en ARCA. Un cliente que ramifique sólo por 4xx/5xx acierta al revés en los dos.\n\n**Ausente significa \"no lo sabemos\"**, y es distinto de `false`: ahí corresponde la heurística de siempre. Sólo se declara donde la respuesta es certera.","uniqueKey":"retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"number","example":43200,"description":"Cuántos segundos esperar antes de reintentar. **Sólo cuando el número es real** —el vencimiento de un ticket, la ventana de un límite—, nunca una estimación.\n\nEl 429 y el bloqueo del segundo factor ya lo mandaban como `details.reintentarEnSegundos`, en castellano y anidado. Sigue ahí para no romper a nadie, y ahora **también arriba**, con el nombre del resto del sobre.","uniqueKey":"retryAfterSeconds","typeLabel":"number"},"requestId":{"type":"string","example":"0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e","description":"El mismo valor de la cabecera `X-Request-Id`. Es lo que hay que pegar en un ticket.","uniqueKey":"requestId","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":401,"errorCode":"UNAUTHORIZED","message":"No autorizado","timestamp":"2026-07-26T18:30:00.000Z","path":"/v1/invoices/authorize","details":"\u003cstring>","retryable":false,"retryAfterSeconds":43200,"requestId":"0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"}}},"exampleType":"generated"}},"headers":{"X-Request-Id":{"description":"Identificador del pedido. Va en TODA respuesta. Si lo mandás en el pedido y respeta `[A-Za-z0-9._:-]{1,128}`, se te devuelve el mismo; si no, se genera uno. Es lo que hay que citar en un ticket.","schema":{"type":"string"}},"X-Emissa-Mode":{"description":"`test` o `live`. **Va en toda respuesta autenticada con API key**, y es la forma más barata de verificar que no estás emitiendo contra el ambiente equivocado. No aparece cuando se entra con sesión de panel: ahí el ambiente lo decide cada contribuyente, no la credencial.","schema":{"type":"string","enum":["test","live"]}}},"exampleType":"generated"}},"security":{"a2cdf807-94c2-4c5f-ab6a-e7e1f52b074d":{"api-key":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key de integración. **El modo va en el prefijo**: `emi_test_` opera contra homologación, `emi_live_` contra producción. Después, 64 hexadecimales.","scopes":[],"schemeName":"api-key"}},"6af7c2f9-a2e5-4d2a-ac6e-c065e158396d":{"panel-jwt":{"scheme":"bearer","bearerFormat":"JWT","type":"http","description":"Sesión del panel. **No** es donde va la API key.","scopes":[],"schemeName":"panel-jwt"}}},"servers":{"4c3ac454-1611-42e6-9972-fdce75c66d95":{"url":"https://api.emissa.com.ar","description":"Producción"},"59c0321e-fc8e-4fd2-8484-7481e01419e1":{"url":"http://localhost:3001","description":"Local"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key de integración. **El modo va en el prefijo**: `emi_test_` opera contra homologación, `emi_live_` contra producción. Después, 64 hexadecimales.","scopes":[],"schemeName":"api-key"},"schema":{"title":"X-API-Key","type":"string","description":"API key de integración. **El modo va en el prefijo**: `emi_test_` opera contra homologación, `emi_live_` contra producción. Después, 64 hexadecimales.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"api-key","name":"X-API-Key"}],"title":"api-key"},{"schemes":[{"scheme":{"scheme":"bearer","bearerFormat":"JWT","type":"http","description":"Sesión del panel. **No** es donde va la API key.","scopes":[],"schemeName":"panel-jwt"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Sesión del panel. **No** es donde va la API key.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"panel-jwt","name":"Authorization"}],"title":"panel-jwt"}]},"originalFileLocation":"https://api.emissa.com.ar/openapi.json"},"subdomain":"emissa","siteName":"Emissa","title":"Consumo del período - Emissa","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-20T17:08:37.651Z","originalFileLocation":"api-reference/consumo/consumo-del-período.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"El total de la organización más el desglose por CUIT. La unidad es el comprobante autorizado por ARCA. Un rechazo no cuenta. Las consultas al padrón, la constatación de CAE y los PDF se miden pero no consumen cuota, así que aparecen en total y no en billable. cuitActivos son los contribuyentes que emitieron al menos un comprobante en el período: se derivan de los eventos, no se aprovisionan, así que un contribuyente dormido no cuenta. La cuota es blanda: excederla no bloquea ninguna emisión. Cuando se excede, excedente dice por cuánto y excedenteUnitarioArs a qué precio se factura. Scope de API key: invoice:read. Una key sin ese scope recibe 403 API_KEY_INSUFFICIENT_SCOPE, aunque el rol de quien la creó lo permita: el permiso efectivo es la intersección de los dos.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Emissa\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/emissa/WZ2UJ_VM2VRN59-L/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/emissa/WZ2UJ_VM2VRN59-L/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/emissa/WZ2UJ_VM2VRN59-L/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/emissa/WZ2UJ_VM2VRN59-L/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/emissa/WZ2UJ_VM2VRN59-L/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/emissa/WZ2UJ_VM2VRN59-L/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/emissa/WZ2UJ_VM2VRN59-L/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/emissa/WZ2UJ_VM2VRN59-L/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/emissa/WZ2UJ_VM2VRN59-L/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Consumo del período - Emissa\">\u003cmeta data-mint-head property=\"og:description\" content=\"El total de la organización más el desglose por CUIT. La unidad es el comprobante autorizado por ARCA. Un rechazo no cuenta. Las consultas al padrón, la constatación de CAE y los PDF se miden pero no consumen cuota, así que aparecen en total y no en billable. cuitActivos son los contribuyentes que emitieron al menos un comprobante en el período: se derivan de los eventos, no se aprovisionan, así que un contribuyente dormido no cuenta. La cuota es blanda: excederla no bloquea ninguna emisión. Cuando se excede, excedente dice por cuánto y excedenteUnitarioArs a qué precio se factura. Scope de API key: invoice:read. Una key sin ese scope recibe 403 API_KEY_INSUFFICIENT_SCOPE, aunque el rol de quien la creó lo permita: el permiso efectivo es la intersección de los dos.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Emissa\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.emissa.com.ar/docs/api-reference/consumo/consumo-del-período\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://emissa.mintlify.app/_mintlify/api/og/v2?division=Consumo\u0026amp;title=Consumo+del+per%C3%ADodo\u0026amp;description=El+total+de+la+organizaci%C3%B3n+m%C3%A1s+el+desglose+por+CUIT.%0A%0A**La+unidad+es+el+comprobante+autorizado+por+ARCA.**+Un+rechazo+no+cuenta.+Las+consultas+al+padr%C3%B3n%2C+la+co\u0026amp;theme=86e15709e365c8147b74cd50\u0026amp;signature=9ff7e16bbeda8a8d6faf84642eba01ae2825692901f80d63690e914da1c2c451\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Consumo del período - Emissa\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"El total de la organización más el desglose por CUIT. La unidad es el comprobante autorizado por ARCA. Un rechazo no cuenta. Las consultas al padrón, la constatación de CAE y los PDF se miden pero no consumen cuota, así que aparecen en total y no en billable. cuitActivos son los contribuyentes que emitieron al menos un comprobante en el período: se derivan de los eventos, no se aprovisionan, así que un contribuyente dormido no cuenta. La cuota es blanda: excederla no bloquea ninguna emisión. Cuando se excede, excedente dice por cuánto y excedenteUnitarioArs a qué precio se factura. Scope de API key: invoice:read. Una key sin ese scope recibe 403 API_KEY_INSUFFICIENT_SCOPE, aunque el rol de quien la creó lo permita: el permiso efectivo es la intersección de los dos.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://emissa.mintlify.app/_mintlify/api/og/v2?division=Consumo\u0026amp;title=Consumo+del+per%C3%ADodo\u0026amp;description=El+total+de+la+organizaci%C3%B3n+m%C3%A1s+el+desglose+por+CUIT.%0A%0A**La+unidad+es+el+comprobante+autorizado+por+ARCA.**+Un+rechazo+no+cuenta.+Las+consultas+al+padr%C3%B3n%2C+la+co\u0026amp;theme=86e15709e365c8147b74cd50\u0026amp;signature=9ff7e16bbeda8a8d6faf84642eba01ae2825692901f80d63690e914da1c2c451\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/emissa/WZ2UJ_VM2VRN59-L/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Emissa\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0c0cc8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.emissa.com.ar/docs/api-reference/consumo/consumo-del-período\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/consumo/consumo-del-per%C3%ADodo.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.emissa.com.ar/#organization\",\"name\":\"Emissa\",\"url\":\"https://www.emissa.com.ar\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/emissa/54zD7qivv8TCTuUU/images/marca/navigation-positive-on-white.svg?fit=max\u0026auto=format\u0026n=54zD7qivv8TCTuUU\u0026q=85\u0026s=31720f0a4e045e64fd37cff5a02df0d4\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.emissa.com.ar/docs#website\",\"name\":\"Emissa\",\"url\":\"https://www.emissa.com.ar/docs\",\"publisher\":{\"@id\":\"https://www.emissa.com.ar/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.emissa.com.ar/docs/api-reference/consumo/consumo-del-per%C3%ADodo#webpage\",\"url\":\"https://www.emissa.com.ar/docs/api-reference/consumo/consumo-del-per%C3%ADodo\",\"name\":\"Consumo del período\",\"description\":\"El total de la organización más el desglose por CUIT. La unidad es el comprobante autorizado por ARCA. Un rechazo no cuenta. Las consultas al padrón, la constatación de CAE y los PDF se miden pero no consumen cuota, así que aparecen en total y no en billable. cuitActivos son los contribuyentes que emitieron al menos un comprobante en el período: se derivan de los eventos, no se aprovisionan, así que un contribuyente dormido no cuenta. La cuota es blanda: excederla no bloquea ninguna emisión. Cuando se excede, excedente dice por cuánto y excedenteUnitarioArs a qué precio se factura. Scope de API key: invoice:read. Una key sin ese scope recibe 403 API_KEY_INSUFFICIENT_SCOPE, aunque el rol de quien la creó lo permita: el permiso efectivo es la intersección de los dos.\",\"dateModified\":\"2026-10-20T17:08:37.651Z\",\"isPartOf\":{\"@id\":\"https://www.emissa.com.ar/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.emissa.com.ar/docs/api-reference/consumo/consumo-del-per%C3%ADodo#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.emissa.com.ar/docs/api-reference/consumo/consumo-del-per%C3%ADodo#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Emissa\",\"item\":\"https://www.emissa.com.ar/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Consumo del período\",\"item\":\"https://www.emissa.com.ar/docs/api-reference/consumo/consumo-del-per%C3%ADodo\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.emissa.com.ar/docs/api-reference/consumo/consumo-del-per%C3%ADodo#apireference\",\"headline\":\"Consumo del período\",\"name\":\"Consumo del período\",\"description\":\"El total de la organización más el desglose por CUIT. La unidad es el comprobante autorizado por ARCA. Un rechazo no cuenta. Las consultas al padrón, la constatación de CAE y los PDF se miden pero no consumen cuota, así que aparecen en total y no en billable. cuitActivos son los contribuyentes que emitieron al menos un comprobante en el período: se derivan de los eventos, no se aprovisionan, así que un contribuyente dormido no cuenta. La cuota es blanda: excederla no bloquea ninguna emisión. Cuando se excede, excedente dice por cuánto y excedenteUnitarioArs a qué precio se factura. Scope de API key: invoice:read. Una key sin ese scope recibe 403 API_KEY_INSUFFICIENT_SCOPE, aunque el rol de quien la creó lo permita: el permiso efectivo es la intersección de los dos.\",\"url\":\"https://www.emissa.com.ar/docs/api-reference/consumo/consumo-del-per%C3%ADodo\",\"mainEntityOfPage\":{\"@id\":\"https://www.emissa.com.ar/docs/api-reference/consumo/consumo-del-per%C3%ADodo#webpage\"},\"dateModified\":\"2026-10-20T17:08:37.651Z\",\"publisher\":{\"@id\":\"https://www.emissa.com.ar/#organization\"},\"isPartOf\":{\"@id\":\"https://www.emissa.com.ar/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Emissa\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Emissa","nav":{"global":null,"tabs":[{"tab":"Guías","pages":[{"title":"Guías","href":"/guias/inicio"}]},{"tab":"Referencia de la API","groups":[{"group":"Contribuyentes","pages":[{"title":"Listar contribuyentes","deprecated":null,"version":null,"openapi":"https://api.emissa.com.ar/openapi.json get /v1/taxpayers","href":"/api-reference/contribuyentes/listar-contribuyentes"},{"title":"Alta o edición de un contribuyente","deprecated":null,"version":null,"openapi":"https://api.emissa.com.ar/openapi.json post /v1/taxpayers","href":"/api-reference/contribuyentes/alta-o-edición-de-un-contribuyente"},{"title":"Verificar la conexión con ARCA","deprecated":null,"version":null,"openapi":"https://api.emissa.com.ar/openapi.json post /v1/taxpayers/{id}/conexion/verificar","href":"/api-reference/contribuyentes/verificar-la-conexión-con-arca"},{"title":"Descargar el logo del emisor","deprecated":null,"version":null,"openapi":"https://api.emissa.com.ar/openapi.json get /v1/taxpayers/{id}/logo","href":"/api-reference/contribuyentes/descargar-el-logo-del-emisor"},{"title":"Subir o reemplazar el logo del emisor","deprecated":null,"version":null,"openapi":"https://api.emissa.com.ar/openapi.json put /v1/taxpayers/{id}/logo","href":"/api-reference/contribuyentes/subir-o-reemplazar-el-logo-del-emisor"},{"title":"Borrar el logo del emisor","deprecated":null,"version":null,"openapi":"https://api.emissa.com.ar/openapi.json delete /v1/taxpayers/{id}/logo","href":"/api-reference/contribuyentes/borrar-el-logo-del-emisor"},{"title":"Consultar el padrón de ARCA por CUIT","deprecated":null,"version":null,"openapi":"https://api.emissa.com.ar/openapi.json get /v1/arca/padron/{cuit}","href":"/api-reference/contribuyentes/consultar-el-padrón-de-arca-por-cuit"}]},{"group":"Credenciales ARCA","pages":[{"title":"Historial de credenciales","deprecated":null,"version":null,"openapi":"https://api.emissa.com.ar/openapi.json get /v1/arca/credentials","href":"/api-reference/credenciales-arca/historial-de-credenciales"},{"title":"Cargar el certificado y la clave privada","deprecated":null,"version":null,"openapi":"https://api.emissa.com.ar/openapi.json post /v1/arca/credentials","href":"/api-reference/credenciales-arca/cargar-el-certificado-y-la-clave-privada"},{"title":"Revocar una credencial","deprecated":null,"version":null,"openapi":"https://api.emissa.com.ar/openapi.json delete /v1/arca/credentials/{id}","href":"/api-reference/credenciales-arca/revocar-una-credencial"}]},{"group":"Clientes","pages":[{"title":"Validar un receptor contra el padrón de ARCA","deprecated":null,"version":null,"openapi":"https://api.emissa.com.ar/openapi.json post /v1/customers/validate-tax","href":"/api-reference/clientes/validar-un-receptor-contra-el-padrón-de-arca"}]},{"group":"Comprobantes","pages":[{"title":"Emitir un comprobante","deprecated":null,"version":null,"openapi":"https://api.emissa.com.ar/openapi.json post /v1/invoices/authorize","href":"/api-reference/comprobantes/emitir-un-comprobante"},{"title":"Listar comprobantes","deprecated":null,"version":null,"openapi":"https://api.emissa.com.ar/openapi.json get /v1/invoices/search","href":"/api-reference/comprobantes/listar-comprobantes"},{"title":"Exportar el histórico","deprecated":null,"version":null,"openapi":"https://api.emissa.com.ar/openapi.json get /v1/invoices/export","href":"/api-reference/comprobantes/exportar-el-histórico"},{"title":"Anular un comprobante","deprecated":null,"version":null,"openapi":"https://api.emissa.com.ar/openapi.json post /v1/invoices/{id}/cancel","href":"/api-reference/comprobantes/anular-un-comprobante"},{"title":"Reconciliar un comprobante sin resolver","deprecated":null,"version":null,"openapi":"https://api.emissa.com.ar/openapi.json post /v1/invoices/{id}/reconcile","href":"/api-reference/comprobantes/reconciliar-un-comprobante-sin-resolver"},{"title":"Comprobantes sin resolver","deprecated":null,"version":null,"openapi":"https://api.emissa.com.ar/openapi.json get /v1/invoices/unresolved","href":"/api-reference/comprobantes/comprobantes-sin-resolver"},{"title":"Un comprobante por id","deprecated":null,"version":null,"openapi":"https://api.emissa.com.ar/openapi.json get /v1/invoices/{id}","href":"/api-reference/comprobantes/un-comprobante-por-id"},{"title":"PDF del comprobante","description":"El comprobante impreso, con el QR de la RG 4892.\n\n**Sólo si está autorizado**: un comprobante sin CAE no es un comprobante, y entregar el PDF invitaría a usarlo como si fuera válido. En cualquier otro estado devuelve `422 INVOICE_NOT_AUTHORIZED`.\n\n**Scope de API key:** `invoice:read`. Una key sin ese scope recibe `403 API_KEY_INSUFFICIENT_SCOPE`, aunque el rol de quien la creó lo permita: el permiso efectivo es la **intersección** de los dos.","deprecated":null,"version":null,"openapi":"https://api.emissa.com.ar/openapi.json get /v1/invoices/{id}/pdf","href":"/api-reference/comprobantes/pdf-del-comprobante"}]},{"group":"Consumo","pages":[{"title":"Consumo del período","deprecated":null,"version":null,"openapi":"https://api.emissa.com.ar/openapi.json get /v1/consumo","href":"/api-reference/consumo/consumo-del-período"}]}]}]},"basePath":"","title":"Consumo del período - Emissa","buildId":"dpl_6cCEiK8XNNvaLBBkWzcBhdE9QfLC","deploymentId":"dpl_6cCEiK8XNNvaLBBkWzcBhdE9QfLC","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CLz2_Z5D.js","utils-7A5jZhOT.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BVWmkKuv.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-4SOfrh0F.js","snippetPresets-CMc8KicP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ba9tX7z3.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Be8krXvv.js","shallow-CBC3K1uB.js","getApiPlaygroundDisplay-4tKcUAYo.js","CodeSnippet-C1Xa06ft.js","CodeSnippets-vqiz27A_.js","Page-DeQN5MDd.js","getPastedJson-NUwRfM32.js","icon-DkIVqWh9.js","MethodPill-qmhT7_wz.js","DuplicateIcon-_gWp1vhn.js","createIcon-NA1p_TVA.js","DynamicMarkdown-Bas9A7wq.js","SectionHeading-a1cS-24U.js","axios-vUo_bRtp.js","Markdown-D3ZTwq_a.js","clsx-BcghKhHb.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-B66mVNPp.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DmooSyTN.js"]}