Agregar un CUIT

curl --request POST \
  --url https://www.facture.ar/api/cuits \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "number": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({number: '<string>'})
};

fetch('https://www.facture.ar/api/cuits', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://www.facture.ar/api/cuits"

payload = { "number": "<string>" }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.facture.ar/api/cuits",
  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([
    'number' => '<string>'
  ]),
  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;
}

{
  "id": "cm1a2b3c4d5e6f7g8h9i0j",
  "number": "20-12345678-9",
  "testing_certificate_valid": true,
  "production_certificate_valid": true,
  "testing_afip_connection_valid": true,
  "production_afip_connection_valid": true,
  "is_default": true,
  "setupStatus": "INITIALIZED",
  "userId": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "persona": {},
  "personaLastUpdated": "2023-11-07T05:31:56Z",
  "pos": {},
  "posLastUpdated": "2023-11-07T05:31:56Z",
  "default_pos": 1,
  "default_concept": 2,
  "default_invoice_type": 11,
  "default_iva": 5,
  "production_certificate_expiration": "2023-11-07T05:31:56Z",
  "production_ta_expiration": "2023-11-07T05:31:56Z",
  "testing_certificate_expiration": "2023-11-07T05:31:56Z",
  "testing_ta_expiration": "2023-11-07T05:31:56Z",
  "integrationMode": "DELEGATION",
  "testingSetupState": "REQUESTED",
  "productionSetupState": "REQUESTED"
}

{
  "error": "<string>",
  "code": "<string>",
  "message": "<string>",
  "resolution": "<string>",
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "details": "<unknown>"
}

{
  "error": "<string>",
  "code": "<string>",
  "message": "<string>",
  "resolution": "<string>",
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "details": "<unknown>"
}

{
  "error": "<string>",
  "code": "<string>",
  "message": "<string>",
  "resolution": "<string>",
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "details": "<unknown>"
}

POST

cuits

Agregar un CUIT

curl --request POST \
  --url https://www.facture.ar/api/cuits \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "number": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({number: '<string>'})
};

fetch('https://www.facture.ar/api/cuits', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://www.facture.ar/api/cuits"

payload = { "number": "<string>" }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.facture.ar/api/cuits",
  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([
    'number' => '<string>'
  ]),
  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;
}

{
  "id": "cm1a2b3c4d5e6f7g8h9i0j",
  "number": "20-12345678-9",
  "testing_certificate_valid": true,
  "production_certificate_valid": true,
  "testing_afip_connection_valid": true,
  "production_afip_connection_valid": true,
  "is_default": true,
  "setupStatus": "INITIALIZED",
  "userId": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "persona": {},
  "personaLastUpdated": "2023-11-07T05:31:56Z",
  "pos": {},
  "posLastUpdated": "2023-11-07T05:31:56Z",
  "default_pos": 1,
  "default_concept": 2,
  "default_invoice_type": 11,
  "default_iva": 5,
  "production_certificate_expiration": "2023-11-07T05:31:56Z",
  "production_ta_expiration": "2023-11-07T05:31:56Z",
  "testing_certificate_expiration": "2023-11-07T05:31:56Z",
  "testing_ta_expiration": "2023-11-07T05:31:56Z",
  "integrationMode": "DELEGATION",
  "testingSetupState": "REQUESTED",
  "productionSetupState": "REQUESTED"
}

{
  "error": "<string>",
  "code": "<string>",
  "message": "<string>",
  "resolution": "<string>",
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "details": "<unknown>"
}

{
  "error": "<string>",
  "code": "<string>",
  "message": "<string>",
  "resolution": "<string>",
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "details": "<unknown>"
}

{
  "error": "<string>",
  "code": "<string>",
  "message": "<string>",
  "resolution": "<string>",
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "details": "<unknown>"
}

Authorizations

x-api-key

string

header

required

API Key para autenticación. Formato: test_sk_xxx para testing, prod_sk_xxx para producción.

Body

application/json

number

string

required

Número de CUIT

integrationMode

string

Modo de conexión con ARCA

Response

CUIT creado

CUIT de tu cuenta. Nunca incluye certificados, claves privadas ni tickets de acceso.

string

required

ID del CUIT

Example:

"cm1a2b3c4d5e6f7g8h9i0j"

number

string

required

Número de CUIT en formato XX-XXXXXXXX-X

Pattern: ^[0-9]{2}-[0-9]{8}-[0-9]{1}$

Example:

"20-12345678-9"

testing_certificate_valid

boolean

required

El certificado de homologación es válido

production_certificate_valid

boolean

required

El certificado de producción es válido

testing_afip_connection_valid

boolean

required

La conexión con ARCA en homologación funciona

production_afip_connection_valid

boolean

required

La conexión con ARCA en producción funciona

is_default

boolean

required

Es el CUIT por defecto de la cuenta

setupStatus

enum<string>

required

Estado de la configuración del CUIT

Available options:

INITIALIZED,

IN_PROGRESS,

TEST_CERTIFICATE_COMPLETE,

PROD_CERTIFICATE_COMPLETE,

AWAITING_DELEGATION,

DELEGATION_COMPLETE,

AUTOMATION_IN_PROGRESS,

AUTOMATION_FAILED,

COMPLETED,

SKIPPED

userId

string

required

ID del usuario dueño del CUIT

createdAt

string<date-time>

required

Fecha de creación

updatedAt

string<date-time>

required

Fecha de última actualización

persona

object | null

Datos del padrón de ARCA (datosGenerales, datosMonotributo o datosRegimenGeneral, etc.) tal como los devuelve ARCA

personaLastUpdated

string<date-time> | null

Última actualización de los datos del padrón

pos

object | null

Puntos de venta tal como los devuelve ARCA (FEParamGetPtosVenta). La lista está en ResultGet.PtoVenta

posLastUpdated

string<date-time> | null

Última actualización de los puntos de venta

default_pos

integer | null

Punto de venta por defecto

Example:

1

default_concept

integer | null

Concepto por defecto (1 productos, 2 servicios, 3 productos y servicios)

Example:

2

default_invoice_type

integer | null

Tipo de comprobante por defecto (código de ARCA)

Example:

11

default_iva

integer | null

Alícuota de IVA por defecto (código de ARCA)

Example:

5

production_certificate_expiration

string<date-time> | null

Vencimiento del certificado de producción

production_ta_expiration

string<date-time> | null

Vencimiento del ticket de acceso de producción

testing_certificate_expiration

string<date-time> | null

Vencimiento del certificado de homologación

testing_ta_expiration

string<date-time> | null

Vencimiento del ticket de acceso de homologación

integrationMode

enum<string> | null

Modo de conexión con ARCA

Available options:

DELEGATION,

CERTIFICATE,

null

testingSetupState

enum<string> | null

Estado de la configuración de homologación. Solo viene en GET /cuits

Available options:

REQUESTED,

COMPLETED,

null

productionSetupState

enum<string> | null

Estado de la configuración de producción. Solo viene en GET /cuits

Available options:

REQUESTED,

COMPLETED,

null

Overview

API Endpoints

Agregar un CUIT

Authorizations

Body

Response