VXT ARCA

Inicio

La API permite emitir comprobantes ARCA enviando JSON por HTTPS. Cada cliente recibe una API key asociada a su CUIT emisor.

Alta en ARCA

Antes de usar la API, el CUIT emisor debe delegar los Web Services a VXT Logistica.

Para facturas comunes A/B/C/M

1. Entrar a ARCA con clave fiscal del CUIT que va a emitir comprobantes.
2. Ir a Administrador de Relaciones de Clave Fiscal.
3. Seleccionar Nueva Relacion.
4. Elegir el servicio WebService Facturacion Electronica.
5. Cuando ARCA pida el CUIT del usuario autorizado, ingresar 30718589998.
6. Seleccionar VXT LOGISTICA S.R.L. como tercero que ejecutara el WebService.
7. Confirmar la autorizacion.
8. Informar a VXT para que acepte la relacion pendiente.

Si tambien necesita Factura E

1. Repetir el mismo procedimiento.
2. Elegir el servicio Factura electronica de exportacion.
3. Delegarlo al CUIT 30718589998.
4. Informar a VXT para aceptar la relacion pendiente.

Puntos de venta

• Para facturas comunes, crear un punto de venta de Facturacion Electronica - Web Services.
• Para Factura E, crear un punto de venta de Comprobantes de Exportacion - Web Services.
• No usar puntos de venta de Factura en Linea para esta API.

Autenticacion

Enviar la API key del CUIT emisor en el header Authorization.

Authorization: Bearer API_KEY_DEL_CUIT
Content-Type: application/json

Modo testing

Para probar integraciones sin enviar el comprobante a ARCA, agregar "testing": true en el JSON.

{
  "testing": true,
  "cuit": "CUIT_EMISOR",
  "point_of_sale": 33,
  "voucher_type": 6,
  "concept": 2,
  "doc_type": 99,
  "doc_number": 0,
  "receiver_vat_condition_id": 5,
  "issue_date": "2026-06-29",
  "currency": { "id": "PES", "rate": 1 },
  "amounts": {
    "net": 82.64,
    "vat": 17.36,
    "non_taxed": 0,
    "tax_exempt": 0,
    "tributes": 0,
    "total": 100
  },
  "vat": [
    { "id": 5, "base": 82.64, "amount": 17.36 }
  ]
}

La respuesta mantiene el mismo formato que una emision real, pero devuelve un CAE ficticio.

{
  "success": true,
  "data": {
    "service": "mock-wsfe",
    "result": "A",
    "voucher_number": 123456,
    "cae": "88888888888888",
    "cae_due_date": "2026-07-14",
    "testing": true
  }
}

Consultar datos de un CUIT

Permite consultar datos de padrón de un CUIT. El acceso se valida igual que la emisión: API key del CUIT cliente habilitado y campo cuit en el JSON.

curl -X POST https://vxtlogistica.com/api_arca/v1/taxpayers \
  -H "Authorization: Bearer API_KEY_DEL_CUIT" \
  -H "Content-Type: application/json" \
  --data '{
    "cuit": "CUIT_CLIENTE_HABILITADO",
    "query_cuit": "CUIT_A_CONSULTAR"
  }'

Body

Respuesta

{
  "success": true,
  "data": {
    "service": "ws_sr_constancia_inscripcion",
    "query_cuit": "30718589998",
    "raw": {
      "personaReturn": {
        "datosGenerales": {
          "razonSocial": "..."
        }
      }
    },
    "testing": false
  }
}

Factura A con IVA incluido

Ejemplo por $100 final con IVA 21% incluido. Para Factura A el receptor normalmente se informa con CUIT y condicion IVA Responsable Inscripto.

{
  "cuit": "CUIT_EMISOR",
  "point_of_sale": 33,
  "voucher_type": 1,
  "concept": 2,
  "doc_type": 80,
  "doc_number": 30712345678,
  "receiver_vat_condition_id": 1,
  "issue_date": "2026-06-29",
  "currency": { "id": "PES", "rate": 1 },
  "amounts": {
    "net": 82.64,
    "vat": 17.36,
    "non_taxed": 0,
    "tax_exempt": 0,
    "tributes": 0,
    "total": 100
  },
  "vat": [
    { "id": 5, "base": 82.64, "amount": 17.36 }
  ]
}

Factura B con IVA incluido

Ejemplo por $100 final con IVA 21% incluido.

{
  "cuit": "CUIT_EMISOR",
  "point_of_sale": 33,
  "voucher_type": 6,
  "concept": 2,
  "doc_type": 99,
  "doc_number": 0,
  "receiver_vat_condition_id": 5,
  "issue_date": "2026-06-29",
  "currency": { "id": "PES", "rate": 1 },
  "amounts": {
    "net": 82.64,
    "vat": 17.36,
    "non_taxed": 0,
    "tax_exempt": 0,
    "tributes": 0,
    "total": 100
  },
  "vat": [
    { "id": 5, "base": 82.64, "amount": 17.36 }
  ]
}

Comprobante exento

Para operaciones exentas, no enviar base neta gravada ni alicuota IVA.

{
  "cuit": "CUIT_EMISOR",
  "point_of_sale": 33,
  "voucher_type": 6,
  "concept": 2,
  "doc_type": 99,
  "doc_number": 0,
  "receiver_vat_condition_id": 5,
  "issue_date": "2026-06-29",
  "currency": { "id": "PES", "rate": 1 },
  "amounts": {
    "net": 0,
    "vat": 0,
    "non_taxed": 0,
    "tax_exempt": 100,
    "tributes": 0,
    "total": 100
  },
  "vat": []
}

Nota de credito nacional

Ejemplo de Nota de Credito B asociada a una Factura B.

{
  "cuit": "CUIT_EMISOR",
  "point_of_sale": 33,
  "voucher_type": 8,
  "concept": 2,
  "doc_type": 99,
  "doc_number": 0,
  "receiver_vat_condition_id": 5,
  "issue_date": "2026-06-29",
  "currency": { "id": "PES", "rate": 1 },
  "amounts": {
    "net": 82.64,
    "vat": 17.36,
    "non_taxed": 0,
    "tax_exempt": 0,
    "tributes": 0,
    "total": 100
  },
  "vat": [
    { "id": 5, "base": 82.64, "amount": 17.36 }
  ],
  "associated_docs": [
    { "tipo_comp": 6, "pto_vta": 33, "nro": 3 }
  ]
}

Nota de debito nacional

Ejemplo de Nota de Debito B asociada a una Factura B. Para Nota de Debito A usar voucher_type: 2 y asociar una Factura A con tipo_comp: 1.

{
  "cuit": "CUIT_EMISOR",
  "point_of_sale": 33,
  "voucher_type": 7,
  "concept": 2,
  "doc_type": 99,
  "doc_number": 0,
  "receiver_vat_condition_id": 5,
  "issue_date": "2026-06-29",
  "currency": { "id": "PES", "rate": 1 },
  "amounts": {
    "net": 82.64,
    "vat": 17.36,
    "non_taxed": 0,
    "tax_exempt": 0,
    "tributes": 0,
    "total": 100
  },
  "vat": [
    { "id": 5, "base": 82.64, "amount": 17.36 }
  ],
  "associated_docs": [
    { "tipo_comp": 6, "pto_vta": 33, "nro": 3 }
  ]
}

Factura E

Usar punto de venta de Comprobantes de Exportacion - Web Services. Para Tierra del Fuego/Ushuaia puede corresponder Factura E segun el tratamiento fiscal/aduanero de la operacion.

{
  "cuit": "CUIT_EMISOR",
  "point_of_sale": 34,
  "voucher_type": 19,
  "concept": 2,
  "issue_date": "2026-06-29",
  "service_from": "2026-06-29",
  "service_to": "2026-06-29",
  "payment_due_date": "2026-06-29",
  "currency": { "id": "PES", "rate": 1 },
  "amounts": {
    "net": 200,
    "vat": 0,
    "non_taxed": 0,
    "tax_exempt": 0,
    "tributes": 0,
    "total": 200
  },
  "export": {
    "type": 2,
    "permit_exists": "",
    "destination_country": 250,
    "customer_name": "Cliente Ushuaia",
    "customer_country_cuit": 33654196589,
    "customer_address": "Ushuaia, Tierra del Fuego",
    "tax_id": "33654196589",
    "description": "Servicios",
    "payment_terms": "Contado",
    "payment_date": "2026-06-29",
    "language": 1
  },
  "items": [
    {
      "Pro_codigo": "SERV-001",
      "Pro_ds": "Servicios",
      "Pro_qty": 1,
      "Pro_umed": 7,
      "Pro_precio_uni": 200,
      "Pro_bonificacion": 0,
      "Pro_total_item": 200
    }
  ]
}

Nota de credito E

Asociar la Factura E original usando el mismo punto de venta donde se emitio.

{
  "cuit": "CUIT_EMISOR",
  "point_of_sale": 34,
  "voucher_type": 21,
  "concept": 2,
  "issue_date": "2026-06-29",
  "currency": { "id": "PES", "rate": 1 },
  "amounts": {
    "net": 200,
    "vat": 0,
    "non_taxed": 0,
    "tax_exempt": 0,
    "tributes": 0,
    "total": 200
  },
  "export": {
    "type": 2,
    "permit_exists": "",
    "destination_country": 250,
    "customer_name": "Cliente Ushuaia",
    "customer_country_cuit": 33654196589,
    "customer_address": "Ushuaia, Tierra del Fuego",
    "tax_id": "33654196589",
    "description": "Ajuste",
    "payment_terms": "Contado",
    "language": 1
  },
  "items": [
    {
      "Pro_codigo": "AJUSTE-001",
      "Pro_ds": "Nota de credito",
      "Pro_qty": 1,
      "Pro_umed": 7,
      "Pro_precio_uni": 200,
      "Pro_bonificacion": 0,
      "Pro_total_item": 200
    }
  ],
  "associated_docs": [
    { "tipo_comp": 19, "pto_vta": 34, "nro": 1, "cuit": 30718589998 }
  ]
}

Respuesta exitosa

{
  "success": true,
  "data": {
    "service": "wsfe",
    "result": "A",
    "voucher_number": 123,
    "cae": "12345678901234",
    "cae_due_date": "2026-07-09",
    "qr": {
      "url": "https://www.afip.gob.ar/fe/qr/?p=..."
    },
    "id": 1
  }
}

Errores frecuentes