Guía de uso de la API

/api.php?path=usuario/me

Authorization: Bearer <api_token>
X-Api-Token: <api_token>

{
  "nombre": "Juan Pérez",
  "email": "juan@empresa.com",
  "password": "minimo6"
}

{
  "ok": true,
  "usuario": {
    "id": 1,
    "nombre": "Juan Pérez",
    "email": "juan@empresa.com",
    "api_token": "a1b2c3..."
  }
}

{ "ok": true, "api_token": "nuevo_hex_64..." }

{
  "nombre": "Mi comercio",
  "cuit": "20123456789",
  "condicion": 1,
  "pto_vta": 1,
  "domicilio": "Av. Corrientes 1000",
  "certificado": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----",
  "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----"
}

{
  "ok": true,
  "negocio": {
    "id": 12,
    "nombre": "Mi comercio",
    "cuit": "20123456789",
    "condicion": 1,
    "domicilio": "Av. Corrientes 1000",
    "pto_vta": 1,
    "tiene_credenciales": true
  }
}

{
  "ok": true,
  "padron": {
    "cuit": "20386368563",
    "doc_tipo": 80,
    "razon_social": "PEREZ JUAN",
    "domicilio": "HIDALGO 820 Piso:8 Dpto:E, CIUDAD AUTONOMA BUENOS AIRES, CP 1405",
    "domicilio_detalle": {
      "direccion": "HIDALGO 820 Piso:8 Dpto:E",
      "localidad": "CIUDAD AUTONOMA BUENOS AIRES",
      "provincia": "CIUDAD AUTONOMA BUENOS AIRES",
      "cod_postal": "1405"
    },
    "condicion_iva": 6,
    "condicion_iva_label": "Responsable Monotributo",
    "tipo_persona": "FISICA",
    "estado_clave": "ACTIVO",
    "errores": []
  }
}

{
  "ok": true,
  "comprobantes": [
    {
      "id": 99,
      "negocio_id": 9,
      "negocio_nombre": "Mi comercio",
      "estado": "emitido",
      "fecha_cbte": "2026-09-14",
      "fecha_hora_emision": "2026-09-14 12:34:56",
      "created_at": "2026-09-14 12:34:56"
    }
  ],
  "paginacion": {
    "page": 1,
    "limit": 100,
    "total": 250,
    "pages": 3
  }
}

{
  "negocio_id": 12,
  "cbte_tipo": 6,
  "doc_tipo": 96,
  "doc_nro": "12345678",
  "receptor_nombre": "Juan Pérez",
  "receptor_direccion": "Av. Siempre Viva 123",
  "condicion_venta": 6,
  "items": [
    {
      "descripcion": "Servicio de consultoría",
      "cantidad": 1,
      "precio_unitario": 10000,
      "alicuota_iva": 21,
      "unidad_medida": "UNI"
    }
  ]
}

{
  "negocio_id": 12,
  "cbte_tipo": 1,
  "doc_tipo": 80,
  "doc_nro": "30712345678",
  "receptor_razon_social": "Cliente SA",
  "condicion_iva": 1,
  "receptor_domicilio_comercial": "Av. Siempre Viva 123",
  "receptor_email": "facturacion@cliente.com",
  "concepto": 1,
  "condicion_venta": 1,
  "items": [
    {
      "codigo": "SKU-01",
      "descripcion": "Producto",
      "cantidad": 2,
      "precio_unitario": 1500.50,
      "porcentaje_bonificado": 10,
      "alicuota_iva": 21,
      "unidad_medida": "UNI"
    }
  ]
}

{
  "ok": true,
  "comprobante": {
    "id": 99,
    "estado": "solicitado",
    "cae": "PENDIENTE",
    "numero": 0,
    "importe_total": 12100,
    "importe_neto": 10000,
    "importe_iva": 2100
  },
  "mensaje": "Solicitud registrada. El comprobante se autorizará en ARCA de forma asíncrona (estado: solicitado)."
}

GET  /api.php?path=usuario/me
POST /api.php?path=negocios
POST /api.php?path=negocios/12/credenciales
POST /api.php?path=padron/20386368563
GET  /api.php?path=padron&cuit=20386368563
POST /api.php?path=comprobantes
GET  /api.php?path=comprobantes/99
GET  /api/comprobantes/?id=99

curl -i -H "Authorization: Bearer $TOKEN" \
  "$BASE/api.php?path=padron/20386368563"

curl -i -X POST "$BASE/api.php?path=negocios" \
  -H "Authorization: Bearer $TOKEN" \
  -F "nombre=EVENTO DE PRUEBA NEW" \
  -F "cuit=20386368563" \
  -F "condicion=6" \
  -F "pto_vta=4" \
  -F "domicilio=HIDALGO 820" \
  -F "passphrase=" \
  -F "certificado=@/ruta/certificado.crt;type=application/x-x509-ca-cert" \
  -F "private_key=@/ruta/privada.key;type=application/octet-stream"

curl -i -X POST "$BASE/api.php?path=negocios" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"nombre\":\"Mi comercio\",\"cuit\":\"20123456789\",\"condicion\":6,\"pto_vta\":4,\"certificado\":\"-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\",\"private_key\":\"-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\"}"

TOKEN="..."
BASE="https://emitifacil.com"

curl -s -H "Authorization: Bearer $TOKEN" "$BASE/api/negocios"

curl -s -H "Authorization: Bearer $TOKEN" \
  "$BASE/api/comprobantes?negocio_id=9&desde=2026-09-01&hasta=2026-09-30&page=1&limit=100"

curl -s -X POST "$BASE/api/comprobantes" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "negocio_id": 12,
    "cbte_tipo": 6,
    "doc_tipo": 96,
    "doc_nro": "12345678",
    "receptor_nombre": "Juan Pérez",
    "receptor_direccion": "Av. Siempre Viva 123",
    "items": [{
      "descripcion": "Venta",
      "cantidad": 1,
      "precio_unitario": 1000,
      "alicuota_iva": 21
    }]
  }'

curl -s -H "Authorization: Bearer $TOKEN" "$BASE/api/comprobantes/99"

curl -s -H "X-Api-Token: $TOKEN" "$BASE/api.php?path=usuario/me"