AFIP API Wrapper - Documentación

Índice

Autenticación
Facturación Electrónica (WSFE)
Consulta Padrón
Configuración

Introducción

Esta API permite interactuar con los Web Services de AFIP de manera simple y eficiente. A través de endpoints RESTful, se pueden realizar todas las operaciones disponibles en los servicios SOAP de AFIP, recibiendo respuestas en formato JSON.

Características principales:

Autenticación automática con AFIP
Manejo de sesiones y tokens
Conversión de respuestas SOAP a JSON
Soporte para múltiples servicios (WSFE, Padrón, etc.)

Todos los endpoints deben estar precedidos por /api.

Autenticación

POST /auth

Autenticar con AFIP

Obtiene un token de autenticación para interactuar con los servicios de AFIP.

Parámetros del Cuerpo

Nombre	Tipo	Descripción
service	string	Servicio para el cual se solicita autenticación (ej: wsfe, ws_sr_padron_a5)
ttl	integer	Tiempo de vida del token en segundos (default: 3600)

Ejemplo de Solicitud

{
  "service": "wsfe",
  "ttl": 3600
}

Ejemplo de Respuesta

{
  "token": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz...",
  "sign": "sOCgnYMMP/FlNO...",
  "expiration": "2023-11-24T15:30:45.929"
}

GET /auth/status

Facturación Electrónica (WSFE)

GET /wsfe/status

GET /wsfe/puntos-venta

GET /wsfe/tipos-comprobantes

GET /wsfe/tipos-conceptos

GET /wsfe/tipos-documentos

GET /wsfe/tipos-iva

GET /wsfe/tipos-monedas

GET /wsfe/ultimo-comprobante

Último Comprobante

Obtiene el último número de comprobante autorizado para un punto de venta y tipo de comprobante.

Parámetros de Consulta

Nombre	Tipo	Descripción
punto_venta	integer	Número de punto de venta Requerido
tipo_comprobante	integer	Tipo de comprobante Requerido

Ejemplo de Solicitud

/api/wsfe/ultimo-comprobante?punto_venta=1&tipo_comprobante=6

Ejemplo de Respuesta

{
  "PtoVta": 1,
  "CbteTipo": 6,
  "CbteNro": 45
}

Punto de Venta:

Tipo de Comprobante:

POST /wsfe/crear-comprobante

Crear Comprobante

Genera un nuevo comprobante (factura, nota de crédito, etc) en AFIP.

Parámetros del Cuerpo

Nombre	Tipo	Descripción
punto_venta	integer	Número de punto de venta Requerido
tipo_comprobante	integer	Tipo de comprobante Requerido
concepto	integer	Concepto del comprobante (1=Productos, 2=Servicios, 3=Ambos) Requerido
tipo_documento	integer	Tipo de documento del cliente Requerido
nro_documento	string	Número de documento del cliente Requerido
fecha_comprobante	string	Fecha del comprobante (formato AAAAMMDD)
importe_total	number	Importe total del comprobante Requerido
importe_neto	number	Importe neto gravado Requerido
importe_iva	number	Importe del IVA Requerido
items_iva	array	Detalle de items de IVA (opcional)
fecha_servicio_desde	string	Fecha de inicio del servicio (formato AAAAMMDD, para conceptos 2 y 3)
fecha_servicio_hasta	string	Fecha de fin del servicio (formato AAAAMMDD, para conceptos 2 y 3)
fecha_vencimiento_pago	string	Fecha de vencimiento del pago (formato AAAAMMDD, para conceptos 2 y 3)

Ejemplo de Solicitud

{
  "punto_venta": 1,
  "tipo_comprobante": 6,
  "concepto": 1,
  "tipo_documento": 80,
  "nro_documento": "20111111112",
  "fecha_comprobante": "20231124",
  "importe_total": 1210.0,
  "importe_neto": 1000.0,
  "importe_iva": 210.0,
  "items_iva": [
    {
      "tipo_iva": 5,
      "base_imponible": 1000.0,
      "importe": 210.0
    }
  ]
}

Ejemplo de Respuesta

{
  "FeDetResp": {
    "FECAEDetResponse": {
      "CAE": "73856178398527",
      "CAEFchVto": "20231204",
      "Concepto": 1,
      "DocNro": "20111111112",
      "DocTipo": 80,
      "CbteDesde": 46,
      "CbteHasta": 46,
      "CbteFch": "20231124",
      "Resultado": "A",
      "Observaciones": null
    }
  },
  "FeCabResp": {
    "Resultado": "A",
    "PtoVta": 1,
    "CbteTipo": 6,
    "FchProceso": "20231124161432",
    "CantReg": 1,
    "Reproceso": "N"
  }
}

GET /wsfe/consultar-comprobante

Consultar Comprobante

Consulta un comprobante existente en AFIP.

Parámetros de Consulta

Nombre	Tipo	Descripción
punto_venta	integer	Número de punto de venta Requerido
tipo_comprobante	integer	Tipo de comprobante Requerido
numero	integer	Número de comprobante Requerido

Ejemplo de Solicitud

/api/wsfe/consultar-comprobante?punto_venta=1&tipo_comprobante=6&numero=46

Ejemplo de Respuesta

{
  "ResultGet": {
    "Concepto": 1,
    "DocTipo": 80,
    "DocNro": "20111111112",
    "CbteDesde": 46,
    "CbteHasta": 46,
    "CbteFch": "20231124",
    "ImpTotal": 1210.0,
    "ImpNeto": 1000.0,
    "ImpIVA": 210.0,
    "FchServDesde": null,
    "FchServHasta": null,
    "FchVtoPago": null,
    "MonId": "PES",
    "MonCotiz": 1,
    "Iva": {
      "AlicIva": [
        {
          "Id": 5,
          "BaseImp": 1000.0,
          "Importe": 210.0
        }
      ]
    },
    "Resultado": "A",
    "CodAutorizacion": "73856178398527",
    "FchVto": "20231204",
    "FchProceso": "20231124161432",
    "Observaciones": null
  }
}

Punto de Venta:

Tipo de Comprobante:

Número:

Consulta Padrón

GET /padron/consultar

Consultar Padrón

Consulta información de un contribuyente en el padrón de AFIP.

Parámetros de Consulta

Nombre	Tipo	Descripción
cuit	string	CUIT del contribuyente a consultar Requerido

Ejemplo de Solicitud

/api/padron/consultar?cuit=20111111112

Ejemplo de Respuesta

{
  "persona": {
    "datosGenerales": {
      "apellido": "PEREZ",
      "nombre": "JUAN",
      "razonSocial": null,
      "tipoPersona": "FISICA",
      "tipoDocumento": "CUIT",
      "numeroDocumento": "20111111112",
      "mesCierre": 12,
      "tipoClave": "CUIT",
      "estadoClave": "ACTIVO"
    },
    "domicilioFiscal": {
      "direccion": "CALLE FALSA 123",
      "localidad": "CAPITAL FEDERAL",
      "codPostal": "1000",
      "idProvincia": 0,
      "descripcionProvincia": "CIUDAD AUTONOMA BUENOS AIRES"
    },
    "datosRegimenGeneral": {
      "impuestos": [
        {
          "idImpuesto": 10,
          "descripcionImpuesto": "IVA",
          "periodo": 201901
        },
        {
          "idImpuesto": 11,
          "descripcionImpuesto": "GANANCIAS PERSONAS FISICAS",
          "periodo": 201901
        }
      ],
      "categoriaAutonomo": null,
      "actividadesPrincipales": [
        {
          "idActividad": 620100,
          "descripcionActividad": "SERVICIOS DE CONSULTORES EN INFORMATICA Y SUMINISTROS DE PROGRAMAS DE INFORMATICA",
          "nomenclador": 883,
          "periodo": 201901
        }
      ]
    },
    "datosMonotributo": null
  }
}

CUIT:

Configuración

Variables de Entorno

Para configurar correctamente esta API, es necesario establecer las siguientes variables de entorno:

Variable	Descripción	Ejemplo
`AFIP_CERT_PATH`	Ruta al certificado de AFIP o contenido del certificado	`/path/to/certificate.crt`
`AFIP_PRIVATE_KEY_PATH`	Ruta a la clave privada o contenido de la clave	`/path/to/private.key`
`AFIP_CUIT`	CUIT del emisor	`20111111112`
`AFIP_ENVIRONMENT`	Entorno de AFIP (test o prod)	`test`
`DEBUG`	Habilitar modo debug	`True`
`SESSION_SECRET`	Clave secreta para la sesión de Flask	`random-secret-key`

Documentación de la API

Características principales:

Autenticación

Autenticar con AFIP

Parámetros del Cuerpo

Ejemplo de Solicitud

Ejemplo de Respuesta

Estado de Autenticación

Ejemplo de Respuesta

Facturación Electrónica (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

Alícuotas de IVA

Ejemplo de Respuesta

Tipos de Monedas

Ejemplo de Respuesta

Último Comprobante

Parámetros de Consulta

Ejemplo de Solicitud

Ejemplo de Respuesta

Crear Comprobante

Parámetros del Cuerpo

Ejemplo de Solicitud

Ejemplo de Respuesta

Consultar Comprobante

Parámetros de Consulta

Ejemplo de Solicitud

Ejemplo de Respuesta

Consulta Padrón

Consultar Padrón

Parámetros de Consulta

Ejemplo de Solicitud

Ejemplo de Respuesta

Configuración