Skip to main content
GET
Consumo del período

Authorizations

X-API-Key
string
header
required

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.

Headers

X-Emissa-Producto
string

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.

Pattern: ^[a-z0-9-]{1,32}$
Example:

"inmos"

Query Parameters

periodo
string

YYYY-MM en zona argentina. Por defecto, el período en curso.

Example:

"2026-07"

contribuyente
string

Id de un contribuyente, para ver sólo el suyo. Sin esto viene el total de la organización con el desglose por CUIT.

producto
string

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.

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.

period
string
required

El período, YYYY-MM.

Example:

"2026-07"

plan
string
required

El plan contratado, que determina el límite y el precio del excedente.

Example:

"STARTER"

organization
object
required

El total de la organización, sumando todos sus CUIT.

taxpayers
object[]
required

Desglose por CUIT. Con una API key viene acotado a los contribuyentes que esa key alcanza.

porProducto
object[]
required

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).