AFIP API Connect - Documentacion

Indice

Formato de respuestas
Autenticacion
Facturacion Electronica (WSFE)
Consulta Padron
Health Checks
Configuracion

Introduccion

API REST multi-empresa que convierte los Web Services SOAP de AFIP a endpoints JSON. Soporta multiples empresas, cada una con sus propios certificados y tokens de autenticacion.

Caracteristicas principales:

Arquitectura multi-empresa con aislamiento por company_id
Autenticacion automatica con AFIP (WSAA)
Conversion de respuestas SOAP a JSON
Soporte para WSFE (facturacion), Padron y mas

Todos los endpoints de la API v2 usan el prefijo /api/v2/companies/{company_id}/.

Formato de respuestas

Todas las respuestas siguen una estructura estandar:

Respuesta exitosa

{
  "status": "success",
  "code": 200,
  "data": { ... }
}

Respuesta de error

{
  "status": "error",
  "code": 400,
  "message": "Descripcion del error"
}

Codigos de error comunes

Codigo	Descripcion
`400`	Parametros faltantes o invalidos
`403`	Empresa inactiva
`404`	Empresa no encontrada
`500`	Error interno o error de AFIP

Autenticacion

POST /api/v2/companies/{company_id}/auth

Nombre	Tipo	Requerido	Descripcion
service	string	No	Servicio AFIP a autenticar. Default: `wsfe`. Valores: `wsfe`, `ws_sr_padron_a5`

GET /api/v2/companies/{company_id}/auth/status

Facturacion Electronica (WSFE)

GET /api/v2/companies/{company_id}/wsfe/status

GET /api/v2/companies/{company_id}/wsfe/puntos-venta

GET /api/v2/companies/{company_id}/wsfe/tipos-comprobantes

GET /api/v2/companies/{company_id}/wsfe/tipos-conceptos

GET /api/v2/companies/{company_id}/wsfe/tipos-documentos

GET /api/v2/companies/{company_id}/wsfe/tipos-iva

GET /api/v2/companies/{company_id}/wsfe/tipos-monedas

GET /api/v2/companies/{company_id}/wsfe/condiciones-iva-receptor

GET /api/v2/companies/{company_id}/wsfe/ultimo-comprobante

Ultimo comprobante

Obtiene el ultimo numero de comprobante autorizado para un punto de venta y tipo de comprobante.

Query params Requeridos

Nombre	Tipo	Descripcion
punto_venta	integer	Numero de punto de venta
tipo_comprobante	integer	Tipo de comprobante

Ejemplo de solicitud

curl "http://localhost:8000/api/v2/companies/1/wsfe/ultimo-comprobante?punto_venta=1&tipo_comprobante=6"

Ejemplo de respuesta

{
  "status": "success",
  "code": 200,
  "data": {
    "PtoVta": 1,
    "CbteTipo": 6,
    "CbteNro": 45
  }
}

Punto de Venta:

Tipo de Comprobante:

POST /api/v2/companies/{company_id}/wsfe/comprobantes

Crear comprobante

Genera un nuevo comprobante (factura, nota de credito, etc.) en AFIP. Tambien disponible como POST /wsfe/crear-comprobante.

Parametros del cuerpo

Nombre	Tipo	Requerido	Descripcion
punto_venta	integer	Si	Numero de punto de venta
tipo_comprobante	integer	Si	Tipo de comprobante (1=Factura A, 6=Factura B, etc.)
concepto	integer	No	1=Productos, 2=Servicios, 3=Ambos. Default: `1`
tipo_documento	integer	Si	Tipo de documento del receptor (80=CUIT, 96=DNI)
nro_documento	string	Si	Numero de documento del receptor
cbte_desde	integer	Si	Numero de comprobante desde
cbte_hasta	integer	Si	Numero de comprobante hasta
fecha_comprobante	string	Si	Fecha del comprobante (formato `YYYYMMDD`)
importe_total	number	Si	Importe total del comprobante
importe_neto	number	No	Importe neto gravado. Default: `0`
importe_iva	number	No	Importe de IVA. Default: `0`
importe_no_gravado	number	No	Importe no gravado. Default: `0`
importe_exento	number	No	Importe exento. Default: `0`
importe_tributos	number	No	Importe de tributos. Default: `0`
moneda_id	string	No	Codigo de moneda. Default: `PES`
moneda_cotizacion	number	No	Cotizacion de la moneda. Default: `1`
condicion_iva_receptor	integer	No	Condicion IVA del receptor. Default: `5` (Consumidor Final)
items_iva	array	No	Detalle de alicuotas de IVA. Cada item: `{ id, base_imponible, importe }`
tributos	array	No	Detalle de tributos. Cada item: `{ id, base_imponible, descripcion, alicuota, importe }`
fecha_servicio_desde	string	No	Fecha inicio servicio (`YYYYMMDD`, requerido para concepto 2 y 3)
fecha_servicio_hasta	string	No	Fecha fin servicio (`YYYYMMDD`, requerido para concepto 2 y 3)
fecha_vencimiento_pago	string	No	Fecha vencimiento pago (`YYYYMMDD`, requerido para concepto 2 y 3)
cbtes_asoc	array	Condicional	Comprobantes asociados. Requerido para NC/ND (tipos 2,3,7,8,12,13). Cada item: `{ tipo, pto_vta, nro, cuit, cbte_fch }`
periodo_asociado	object	Condicional	Alternativa a cbtes_asoc para NC/ND: `{ fecha_desde, fecha_hasta }`

Ejemplo - Factura B simple

{
  "punto_venta": 1,
  "tipo_comprobante": 6,
  "concepto": 1,
  "tipo_documento": 80,
  "nro_documento": "20123456789",
  "cbte_desde": 1,
  "cbte_hasta": 1,
  "fecha_comprobante": "20241201",
  "importe_total": 1210.00,
  "importe_neto": 1000.00,
  "importe_iva": 210.00,
  "items_iva": [
    { "id": 5, "base_imponible": 1000.00, "importe": 210.00 }
  ]
}

Ejemplo - Nota de Credito A con comprobante asociado

{
  "tipo_comprobante": 3,
  "punto_venta": 1,
  "concepto": 1,
  "tipo_documento": 80,
  "nro_documento": "20123456789",
  "cbte_desde": 1,
  "cbte_hasta": 1,
  "fecha_comprobante": "20241201",
  "importe_total": 1000.00,
  "importe_neto": 909.09,
  "importe_iva": 90.91,
  "cbtes_asoc": [
    { "tipo": 1, "pto_vta": 1, "nro": 12345, "cuit": "20123456789", "cbte_fch": "20241101" }
  ]
}

Ejemplo de respuesta

{
  "status": "success",
  "code": 200,
  "data": {
    "FeDetResp": {
      "FECAEDetResponse": {
        "CAE": "73856178398527",
        "CAEFchVto": "20241211",
        "Concepto": 1,
        "DocNro": "20123456789",
        "DocTipo": 80,
        "CbteDesde": 1,
        "CbteHasta": 1,
        "CbteFch": "20241201",
        "Resultado": "A"
      }
    },
    "FeCabResp": {
      "Resultado": "A",
      "PtoVta": 1,
      "CbteTipo": 6,
      "FchProceso": "20241201161432",
      "CantReg": 1,
      "Reproceso": "N"
    },
    "numero_comprobante": 1,
    "punto_venta": 1,
    "tipo_comprobante": 6
  }
}

GET /api/v2/companies/{company_id}/wsfe/comprobantes/consultar

Consultar comprobante

Consulta un comprobante existente en AFIP. Tambien disponible como GET /wsfe/consultar-comprobante.

Query params Requeridos

Nombre	Tipo	Descripcion
punto_venta	integer	Numero de punto de venta
tipo_comprobante	integer	Tipo de comprobante
numero	integer	Numero de comprobante

Ejemplo de solicitud

curl "http://localhost:8000/api/v2/companies/1/wsfe/comprobantes/consultar?punto_venta=1&tipo_comprobante=6&numero=1"

Ejemplo de respuesta

{
  "status": "success",
  "code": 200,
  "data": {
    "ResultGet": {
      "Concepto": 1,
      "DocTipo": 80,
      "DocNro": "20123456789",
      "CbteDesde": 1,
      "CbteHasta": 1,
      "CbteFch": "20241201",
      "ImpTotal": 1210.0,
      "ImpNeto": 1000.0,
      "ImpIVA": 210.0,
      "MonId": "PES",
      "MonCotiz": 1,
      "Iva": {
        "AlicIva": [
          { "Id": 5, "BaseImp": 1000.0, "Importe": 210.0 }
        ]
      },
      "Resultado": "A",
      "CodAutorizacion": "73856178398527",
      "FchVto": "20241211"
    }
  }
}

Punto de Venta:

Tipo de Comprobante:

Numero:

Consulta Padron

GET /api/v2/companies/{company_id}/padron/{cuit}

Consultar padron

Consulta informacion de un contribuyente en el padron de AFIP (servicio ws_sr_padron_a5).

Parametros de ruta

Nombre	Tipo	Descripcion
cuit	string	CUIT del contribuyente a consultar Requerido

Ejemplo de solicitud

curl "http://localhost:8000/api/v2/companies/1/padron/20123456789"

Ejemplo de respuesta

{
  "status": "success",
  "code": 200,
  "data": {
    "persona": {
      "datosGenerales": {
        "apellido": "PEREZ",
        "nombre": "JUAN",
        "razonSocial": null,
        "tipoPersona": "FISICA",
        "tipoDocumento": "CUIT",
        "numeroDocumento": "20123456789",
        "estadoClave": "ACTIVO"
      },
      "domicilioFiscal": {
        "direccion": "CALLE FALSA 123",
        "localidad": "CAPITAL FEDERAL",
        "codPostal": "1000",
        "descripcionProvincia": "CIUDAD AUTONOMA BUENOS AIRES"
      },
      "datosRegimenGeneral": {
        "impuestos": [
          { "idImpuesto": 10, "descripcionImpuesto": "IVA", "periodo": 201901 },
          { "idImpuesto": 11, "descripcionImpuesto": "GANANCIAS PERSONAS FISICAS", "periodo": 201901 }
        ]
      }
    }
  }
}

CUIT:

Health Checks

Los endpoints de health no requieren company_id.

GET /api/health

GET /api/health/database

GET /api/health/afip

Configuracion

Variables de entorno

Variables de entorno necesarias para configurar la API:

Variable	Descripcion	Default
`DATABASE_URL`	Connection string PostgreSQL	Requerida
`SESSION_SECRET`	Secret key para sesiones Flask	`dev-secret-key`
`AFIP_TEST_MODE`	Modo test habilitado (usa mock data)	`True`
`AFIP_ENVIRONMENT`	Entorno AFIP (`test` o `prod`)	`test`

Los certificados AFIP por empresa se configuran desde el panel de administracion o mediante el script scripts/setup_afip_certs.py.

Documentacion de la API v2

Caracteristicas principales:

Formato de respuestas

Respuesta exitosa

Respuesta de error

Codigos de error comunes

Autenticacion

Autenticar con AFIP

Parametros del cuerpo

Ejemplo de solicitud

Ejemplo de respuesta

Estado de autenticacion

Ejemplo de solicitud

Ejemplo de respuesta

Facturacion Electronica (WSFE)

Estado del servicio WSFE

Ejemplo de respuesta

Puntos de venta

Ejemplo de respuesta

Tipos de comprobantes

Ejemplo de respuesta

Tipos de conceptos

Ejemplo de respuesta

Tipos de documentos

Ejemplo de respuesta

Alicuotas de IVA

Ejemplo de respuesta

Tipos de monedas

Ejemplo de respuesta

Condiciones IVA del receptor

Ejemplo de respuesta

Ultimo comprobante

Query params Requeridos

Ejemplo de solicitud

Ejemplo de respuesta

Crear comprobante

Parametros del cuerpo

Ejemplo - Factura B simple

Ejemplo - Nota de Credito A con comprobante asociado

Ejemplo de respuesta

Consultar comprobante

Query params Requeridos

Ejemplo de solicitud

Ejemplo de respuesta

Consulta Padron

Consultar padron

Parametros de ruta

Ejemplo de solicitud

Ejemplo de respuesta

Health Checks

Health check general

Ejemplo de respuesta

Estado de la base de datos

Estado de servicios AFIP

Configuracion