curl --request POST \
--url https://api.emissa.com.ar/v1/taxpayers \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"cuit": "20437136697",
"salePoint": 1,
"environment": "HOMOLOGACION",
"id": "<string>",
"organizationId": "<string>",
"legalName": "Estudio Contable SRL",
"vatStatus": "Responsable Inscripto",
"commercialAddress": "Av. Corrientes 1234, CABA",
"grossIncomeTax": "901-123456-01",
"activityStartDate": "2020-03-01"
}
'import requests
url = "https://api.emissa.com.ar/v1/taxpayers"
payload = {
"cuit": "20437136697",
"salePoint": 1,
"environment": "HOMOLOGACION",
"id": "<string>",
"organizationId": "<string>",
"legalName": "Estudio Contable SRL",
"vatStatus": "Responsable Inscripto",
"commercialAddress": "Av. Corrientes 1234, CABA",
"grossIncomeTax": "901-123456-01",
"activityStartDate": "2020-03-01"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
cuit: '20437136697',
salePoint: 1,
environment: 'HOMOLOGACION',
id: '<string>',
organizationId: '<string>',
legalName: 'Estudio Contable SRL',
vatStatus: 'Responsable Inscripto',
commercialAddress: 'Av. Corrientes 1234, CABA',
grossIncomeTax: '901-123456-01',
activityStartDate: '2020-03-01'
})
};
fetch('https://api.emissa.com.ar/v1/taxpayers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.emissa.com.ar/v1/taxpayers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'cuit' => '20437136697',
'salePoint' => 1,
'environment' => 'HOMOLOGACION',
'id' => '<string>',
'organizationId' => '<string>',
'legalName' => 'Estudio Contable SRL',
'vatStatus' => 'Responsable Inscripto',
'commercialAddress' => 'Av. Corrientes 1234, CABA',
'grossIncomeTax' => '901-123456-01',
'activityStartDate' => '2020-03-01'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.emissa.com.ar/v1/taxpayers"
payload := strings.NewReader("{\n \"cuit\": \"20437136697\",\n \"salePoint\": 1,\n \"environment\": \"HOMOLOGACION\",\n \"id\": \"<string>\",\n \"organizationId\": \"<string>\",\n \"legalName\": \"Estudio Contable SRL\",\n \"vatStatus\": \"Responsable Inscripto\",\n \"commercialAddress\": \"Av. Corrientes 1234, CABA\",\n \"grossIncomeTax\": \"901-123456-01\",\n \"activityStartDate\": \"2020-03-01\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.emissa.com.ar/v1/taxpayers")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"cuit\": \"20437136697\",\n \"salePoint\": 1,\n \"environment\": \"HOMOLOGACION\",\n \"id\": \"<string>\",\n \"organizationId\": \"<string>\",\n \"legalName\": \"Estudio Contable SRL\",\n \"vatStatus\": \"Responsable Inscripto\",\n \"commercialAddress\": \"Av. Corrientes 1234, CABA\",\n \"grossIncomeTax\": \"901-123456-01\",\n \"activityStartDate\": \"2020-03-01\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.emissa.com.ar/v1/taxpayers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"cuit\": \"20437136697\",\n \"salePoint\": 1,\n \"environment\": \"HOMOLOGACION\",\n \"id\": \"<string>\",\n \"organizationId\": \"<string>\",\n \"legalName\": \"Estudio Contable SRL\",\n \"vatStatus\": \"Responsable Inscripto\",\n \"commercialAddress\": \"Av. Corrientes 1234, CABA\",\n \"grossIncomeTax\": \"901-123456-01\",\n \"activityStartDate\": \"2020-03-01\"\n}"
response = http.request(request)
puts response.read_body{
"id": "cmt42x6jb000curi4sz1gyeij",
"organizationId": "cmt42x67e0003uri4u2ii1i7o",
"createdByUserId": "cmt42x67e0001uri4dpdgmvu0",
"cuit": "20000000001",
"legalName": "Estudio Contable SRL",
"vatStatus": "Responsable Inscripto",
"salePoint": 1,
"environment": "HOMOLOGACION",
"productos": [],
"producto": null,
"status": "PENDING",
"hasCredential": false,
"commercialAddress": "Av. Corrientes 1234, CABA",
"grossIncomeTax": "901-123456-01",
"activityStartDate": "2020-03-01",
"datosDelPapel": {
"completo": true,
"faltantes": []
}
}{
"statusCode": 401,
"errorCode": "UNAUTHORIZED",
"message": "No autorizado",
"timestamp": "2026-07-26T18:30:00.000Z",
"path": "/v1/invoices/authorize",
"details": "<string>",
"retryable": false,
"retryAfterSeconds": 43200,
"requestId": "0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"
}{
"statusCode": 401,
"errorCode": "UNAUTHORIZED",
"message": "No autorizado",
"timestamp": "2026-07-26T18:30:00.000Z",
"path": "/v1/invoices/authorize",
"details": "<string>",
"retryable": false,
"retryAfterSeconds": 43200,
"requestId": "0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"
}{
"statusCode": 401,
"errorCode": "UNAUTHORIZED",
"message": "No autorizado",
"timestamp": "2026-07-26T18:30:00.000Z",
"path": "/v1/invoices/authorize",
"details": "<string>",
"retryable": false,
"retryAfterSeconds": 43200,
"requestId": "0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"
}{
"statusCode": 401,
"errorCode": "UNAUTHORIZED",
"message": "No autorizado",
"timestamp": "2026-07-26T18:30:00.000Z",
"path": "/v1/invoices/authorize",
"details": "<string>",
"retryable": false,
"retryAfterSeconds": 43200,
"requestId": "0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"
}{
"statusCode": 401,
"errorCode": "UNAUTHORIZED",
"message": "No autorizado",
"timestamp": "2026-07-26T18:30:00.000Z",
"path": "/v1/invoices/authorize",
"details": "<string>",
"retryable": false,
"retryAfterSeconds": 43200,
"requestId": "0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"
}{
"statusCode": 401,
"errorCode": "UNAUTHORIZED",
"message": "No autorizado",
"timestamp": "2026-07-26T18:30:00.000Z",
"path": "/v1/invoices/authorize",
"details": "<string>",
"retryable": false,
"retryAfterSeconds": 43200,
"requestId": "0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"
}Alta o edición de un contribuyente
Con id edita; sin id da de alta.
Se puede con API key desde la 5.33, si la key tiene taxpayer:write y no está restringida a contribuyentes puntuales. Una key restringida recibe 403: si pudiera crear, el contribuyente nuevo quedaría fuera de su lista y podría operarlo igual, escapándose de su propia restricción.
El organizationId del cuerpo lo usa sólo una sesión de panel. Con API key se ignora: la key opera en su organización y no la elige un parámetro.
La respuesta trae datosDelPapel.faltantes con lo que todavía falta para poder imprimir un comprobante completo.
El alta fija el producto del contribuyente: el de la key, si está atada a uno, o el de X-Emissa-Producto. La edición no lo cambia.
Scope de API key: taxpayer:write. 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.
curl --request POST \
--url https://api.emissa.com.ar/v1/taxpayers \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"cuit": "20437136697",
"salePoint": 1,
"environment": "HOMOLOGACION",
"id": "<string>",
"organizationId": "<string>",
"legalName": "Estudio Contable SRL",
"vatStatus": "Responsable Inscripto",
"commercialAddress": "Av. Corrientes 1234, CABA",
"grossIncomeTax": "901-123456-01",
"activityStartDate": "2020-03-01"
}
'import requests
url = "https://api.emissa.com.ar/v1/taxpayers"
payload = {
"cuit": "20437136697",
"salePoint": 1,
"environment": "HOMOLOGACION",
"id": "<string>",
"organizationId": "<string>",
"legalName": "Estudio Contable SRL",
"vatStatus": "Responsable Inscripto",
"commercialAddress": "Av. Corrientes 1234, CABA",
"grossIncomeTax": "901-123456-01",
"activityStartDate": "2020-03-01"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
cuit: '20437136697',
salePoint: 1,
environment: 'HOMOLOGACION',
id: '<string>',
organizationId: '<string>',
legalName: 'Estudio Contable SRL',
vatStatus: 'Responsable Inscripto',
commercialAddress: 'Av. Corrientes 1234, CABA',
grossIncomeTax: '901-123456-01',
activityStartDate: '2020-03-01'
})
};
fetch('https://api.emissa.com.ar/v1/taxpayers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.emissa.com.ar/v1/taxpayers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'cuit' => '20437136697',
'salePoint' => 1,
'environment' => 'HOMOLOGACION',
'id' => '<string>',
'organizationId' => '<string>',
'legalName' => 'Estudio Contable SRL',
'vatStatus' => 'Responsable Inscripto',
'commercialAddress' => 'Av. Corrientes 1234, CABA',
'grossIncomeTax' => '901-123456-01',
'activityStartDate' => '2020-03-01'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.emissa.com.ar/v1/taxpayers"
payload := strings.NewReader("{\n \"cuit\": \"20437136697\",\n \"salePoint\": 1,\n \"environment\": \"HOMOLOGACION\",\n \"id\": \"<string>\",\n \"organizationId\": \"<string>\",\n \"legalName\": \"Estudio Contable SRL\",\n \"vatStatus\": \"Responsable Inscripto\",\n \"commercialAddress\": \"Av. Corrientes 1234, CABA\",\n \"grossIncomeTax\": \"901-123456-01\",\n \"activityStartDate\": \"2020-03-01\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.emissa.com.ar/v1/taxpayers")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"cuit\": \"20437136697\",\n \"salePoint\": 1,\n \"environment\": \"HOMOLOGACION\",\n \"id\": \"<string>\",\n \"organizationId\": \"<string>\",\n \"legalName\": \"Estudio Contable SRL\",\n \"vatStatus\": \"Responsable Inscripto\",\n \"commercialAddress\": \"Av. Corrientes 1234, CABA\",\n \"grossIncomeTax\": \"901-123456-01\",\n \"activityStartDate\": \"2020-03-01\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.emissa.com.ar/v1/taxpayers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"cuit\": \"20437136697\",\n \"salePoint\": 1,\n \"environment\": \"HOMOLOGACION\",\n \"id\": \"<string>\",\n \"organizationId\": \"<string>\",\n \"legalName\": \"Estudio Contable SRL\",\n \"vatStatus\": \"Responsable Inscripto\",\n \"commercialAddress\": \"Av. Corrientes 1234, CABA\",\n \"grossIncomeTax\": \"901-123456-01\",\n \"activityStartDate\": \"2020-03-01\"\n}"
response = http.request(request)
puts response.read_body{
"id": "cmt42x6jb000curi4sz1gyeij",
"organizationId": "cmt42x67e0003uri4u2ii1i7o",
"createdByUserId": "cmt42x67e0001uri4dpdgmvu0",
"cuit": "20000000001",
"legalName": "Estudio Contable SRL",
"vatStatus": "Responsable Inscripto",
"salePoint": 1,
"environment": "HOMOLOGACION",
"productos": [],
"producto": null,
"status": "PENDING",
"hasCredential": false,
"commercialAddress": "Av. Corrientes 1234, CABA",
"grossIncomeTax": "901-123456-01",
"activityStartDate": "2020-03-01",
"datosDelPapel": {
"completo": true,
"faltantes": []
}
}{
"statusCode": 401,
"errorCode": "UNAUTHORIZED",
"message": "No autorizado",
"timestamp": "2026-07-26T18:30:00.000Z",
"path": "/v1/invoices/authorize",
"details": "<string>",
"retryable": false,
"retryAfterSeconds": 43200,
"requestId": "0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"
}{
"statusCode": 401,
"errorCode": "UNAUTHORIZED",
"message": "No autorizado",
"timestamp": "2026-07-26T18:30:00.000Z",
"path": "/v1/invoices/authorize",
"details": "<string>",
"retryable": false,
"retryAfterSeconds": 43200,
"requestId": "0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"
}{
"statusCode": 401,
"errorCode": "UNAUTHORIZED",
"message": "No autorizado",
"timestamp": "2026-07-26T18:30:00.000Z",
"path": "/v1/invoices/authorize",
"details": "<string>",
"retryable": false,
"retryAfterSeconds": 43200,
"requestId": "0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"
}{
"statusCode": 401,
"errorCode": "UNAUTHORIZED",
"message": "No autorizado",
"timestamp": "2026-07-26T18:30:00.000Z",
"path": "/v1/invoices/authorize",
"details": "<string>",
"retryable": false,
"retryAfterSeconds": 43200,
"requestId": "0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"
}{
"statusCode": 401,
"errorCode": "UNAUTHORIZED",
"message": "No autorizado",
"timestamp": "2026-07-26T18:30:00.000Z",
"path": "/v1/invoices/authorize",
"details": "<string>",
"retryable": false,
"retryAfterSeconds": 43200,
"requestId": "0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"
}{
"statusCode": 401,
"errorCode": "UNAUTHORIZED",
"message": "No autorizado",
"timestamp": "2026-07-26T18:30:00.000Z",
"path": "/v1/invoices/authorize",
"details": "<string>",
"retryable": false,
"retryAfterSeconds": 43200,
"requestId": "0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"
}Authorizations
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
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.
^[a-z0-9-]{1,32}$"inmos"
Body
CUIT con dígito verificador: se valida por módulo 11, no sólo el largo. Un CUIT mal tipeado que pase la validación no se descubre hasta que ARCA rechaza el comprobante, con el número ya consumido.
"20437136697"
Punto de venta habilitado en ARCA para este CUIT.
1 <= x <= 999991
Ambiente de ARCA. PRODUCCION emite comprobantes fiscales reales con CAE real desde la 5.10: entran en los registros del contribuyente, pesan en su declaración y no se borran — se revierten con una nota de crédito. Para probar está HOMOLOGACION, que también emite con CAE real del organismo y no tiene consecuencia fiscal.
Los dos ambientes son conjuntos disjuntos de claves: una API key test contra un contribuyente de PRODUCCION se rechaza con 403.
HOMOLOGACION, PRODUCCION "HOMOLOGACION"
Presente = edición, ausente = alta.
Sólo aplica al alta; si no viene se usa la organización propia. En la edición la organización sale del contribuyente y no se puede mover de tenant por este endpoint.
Razón social, como figura en ARCA. Va impresa en cada comprobante, así que una diferencia con el padrón se ve en el papel.
Opcional desde la 5.13: si no lo mandás se completa desde el padrón de ARCA. Lo que mandés gana siempre — el padrón sólo llena lo que falta. Si no se pudo consultar y hace falta, la respuesta es un 400 que dice por qué.
"Estudio Contable SRL"
Condición del emisor frente al IVA. Es lo que decide qué letra de comprobante puede emitir. Consumidor Final se acepta sólo para no dejar sin editar a quien ya lo tiene cargado: al emitir se rechaza.
Opcional desde la 5.13: si no lo mandás se completa desde el padrón de ARCA. Lo que mandés gana. Consumidor Final no se completa nunca solo: quien no emite comprobantes no puede deducirse del padrón.
Responsable Inscripto, Monotributista, Exento, Consumidor Final "Responsable Inscripto"
Domicilio comercial. Obligatorio en el papel, opcional acá: ver datosDelPapel.faltantes en la respuesta.
255"Av. Corrientes 1234, CABA"
Ingresos Brutos. Texto libre porque el formato real varía: número local, Convenio Multilateral con guiones, o Exento.
64"901-123456-01"
Inicio de actividades. No puede ser futura según el día argentino, no según el reloj del servidor.
"2020-03-01"
Response
El contribuyente, con el estado de sus datos del papel.
Id del contribuyente. Es lo que se manda como taxpayerId al emitir.
"cms5182yf00gxurgsa7fzew8p"
La organización a la que pertenece. Un contribuyente vive en una sola, y una organización puede tener varios CUIT.
"cms5182yf00gxurgsa7fzew8q"
Quién lo dio de alta. null en los que se crearon antes de que se registrara el dato.
El CUIT bajo el que se emite, sin guiones. Tiene que coincidir con el del certificado de ARCA o la carga de credenciales se rechaza.
"20437136697"
Razón social, como va impresa en el comprobante.
"Estudio Contable SRL"
Condición del emisor frente al IVA. Junto con la del receptor decide qué letra de comprobante corresponde.
"Responsable Inscripto"
El punto de venta habilitado en ARCA para esta identidad fiscal. Es un número corto que ARCA asigna y que numera los comprobantes de forma independiente: el 0001 y el 0002 llevan cada uno su propia serie. Tiene que estar dado de alta en ARCA para el ambiente de environment, y el de homologación no sirve en producción.
1
Contra qué ambiente de ARCA se emite. La emisión en PRODUCCION está deshabilitada en esta versión.
HOMOLOGACION, PRODUCCION "HOMOLOGACION"
Los productos de define-it a los que pertenece este contribuyente, o [] si no tiene ninguno. Un contribuyente puede ser de varios: el mismo CUIT lo factura más de un producto. Lo crea el alta —con el producto de la key o, si la key no tiene, el de X-Emissa-Producto— y no cambia por API: sumar o quitar productos lo hace el dueño de la cuenta desde el panel. Una key atada a un producto alcanza a los contribuyentes cuyo productos incluye el suyo.
["inmos", "define"]
Deprecado: usá productos. Es el primero de productos, o null si no tiene ninguno. Se mantiene un tiempo para el cliente que ya lo leía; con más de un producto, no dice cuáles son los demás.
"inmos"
Titularidad del CUIT. Queda en PENDING hasta que se cargue un certificado de ARCA emitido a ese mismo CUIT.
"PENDING"
Si hay una credencial activa para el ambiente de environment. Tener una de homologación no lo pone en true si el contribuyente está en producción.
false
Domicilio comercial. Va impreso en el comprobante.
"Av. Corrientes 1234, CABA"
Ingresos Brutos. Obligatorio en el papel (RG 1415).
"901-123456-01"
Inicio de actividades, YYYY-MM-DD. Va impreso.
"2020-03-01"
Qué falta para que el comprobante impreso cumpla la RG 1415. No bloquea la emisión: sirve para avisar antes de que el contador lo note.
Show child attributes
Show child attributes