Saltar al contenido
Facturador

Ver configuración SUNAT

GET /api/company/sunat-config

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Estado de la configuración de facturación electrónica de la empresa: entorno, modo de envío, credenciales (sin secretos), certificado digital, PSE y qué falta para pasar a producción (ready_for_production). Úsalo antes y después de cada paso.

Quién puede usarlo: solo usuarios de tipo administrador (type = admin). Con el token de un vendedor responde 403.

Formato de respuesta: estándar {success, data, message?} (registro único).

Entorno (soap_type_id):

Valor Alias environment Significado
01 demo Demo / beta: los comprobantes se envían al ambiente de pruebas de SUNAT (u OSE/PSE), sin validez legal.
02 production Producción: los comprobantes se envían a SUNAT con validez legal.

Modo de envío (soap_send_id):

Valor Descripción Credenciales que necesita
01 Sunat (envío directo) Usuario secundario SOL (sunat_sol_username = RUC + usuario) y su clave (sunat_sol_password).
02 Ose Usuario y clave del OSE (ose_username, ose_password) y la URL del servicio (soap_url).
04 OseSendfact Usuario y clave del OSE (ose_username, ose_password).

El envío por PSE (el proveedor firma y envía) no es un valor de soap_send_id: se activa con Configurar PSE (send_document_to_pse: true) y tiene prioridad sobre el modo de envío.

Campos de la respuesta (data):

Campo Descripción
editable false si el proveedor del sistema bloqueó la configuración del entorno (los cambios de entorno, modo, credenciales SOL/OSE y certificado responden 403).
environment soap_type_id (01/02), code (demo/production) y description.
send_mode soap_send_id, description, channel efectivo (sunat, ose o pse) y uses_pse.
sol_user / has_sol_password Usuario secundario SOL vigente y si tiene clave guardada. La clave nunca se devuelve.
soap_url URL del servicio del OSE (solo modo 02).
ose username y has_password del OSE (solo en modo OSE).
sunat_api client_id y has_client_secret de la aplicación API de SUNAT (guías de remisión y SIRE).
has_certificate / certificate Datos públicos del certificado: titular (subject), emisor, RUC detectado, si coincide con la empresa, vigencia (valid_from, valid_to), days_to_expire y expired. null si no hay certificado. Nunca incluye el certificado ni su clave.
pse Configuración PSE sin la contraseña: enabled, provider, user_pse, has_password, has_credentials y las URL opcionales.
ready_for_production ok y missing[] ({code, message}): lo que falta para pasar a producción.
warnings[] Avisos que no bloquean ({code, message}): certificado por vencer (certificate_expiring, 30 días o menos), RUC del certificado no determinado (certificate_ruc_unknown), documentos creados en demo (demo_documents).

Códigos de missing: certificate (no hay certificado), certificate_file (falta el archivo en el servidor), certificate_invalid (no se puede leer), certificate_expired, certificate_ruc_mismatch, send_mode, sol_credentials, sol_username (no empieza con el RUC), ose_credentials, ose_url, pse_provider, pse_user, pse_password. Con PSE no se pide certificado (firma el proveedor).

Errores:

  • 403 si el usuario no es administrador.
  • 401 sin token o con un token inválido.

Respuestas

200 — Lista para producción

{
  "success": true,
  "data": {
    "editable": true,
    "environment": {
      "soap_type_id": "01",
      "code": "demo",
      "description": "Demo"
    },
    "send_mode": {
      "soap_send_id": "01",
      "description": "Sunat",
      "channel": "sunat",
      "uses_pse": false
    },
    "sol_user": "20123456789VENTAS01",
    "has_sol_password": true,
    "soap_url": null,
    "ose": {
      "username": null,
      "has_password": false
    },
    "sunat_api": {
      "client_id": "8c1f2a9e-0b6d-4c1e-9f3a-2d7e5b4a1c90",
      "has_client_secret": true
    },
    "has_certificate": true,
    "certificate": {
      "file_exists": true,
      "readable": true,
      "subject": "EMPRESA DEMO S.A.C.",
      "organization": "EMPRESA DEMO S.A.C.",
      "issuer": "ENTIDAD DE CERTIFICACION ACREDITADA",
      "serial_number": "5A3F09C1D2",
      "ruc": "20123456789",
      "ruc_matches": true,
      "valid_from": "2026-11-01 10:15:00",
      "valid_to": "2027-11-01 10:15:00",
      "days_to_expire": 358,
      "expired": false,
      "not_yet_valid": false
    },
    "pse": {
      "enabled": false,
      "provider": null,
      "pse_provider_id": null,
      "user_pse": null,
      "has_password": false,
      "has_credentials": false,
      "url_signature_pse": null,
      "url_send_cdr_pse": null,
      "url_login_pse": null,
      "client_id_pse": null
    },
    "ready_for_production": {
      "ok": true,
      "missing": []
    },
    "warnings": [
      {
        "code": "demo_documents",
        "message": "Hay documentos creados en demo: bórrelos para evitar conflictos en producción.",
        "types": [
          {
            "description": "Factura/Boleta o Nota de Crédito o Nota de Débito",
            "count": 12
          }
        ]
      }
    ]
  }
}

200 — Faltan requisitos

{
  "success": true,
  "data": {
    "editable": true,
    "environment": {
      "soap_type_id": "01",
      "code": "demo",
      "description": "Demo"
    },
    "send_mode": {
      "soap_send_id": "01",
      "description": "Sunat",
      "channel": "sunat",
      "uses_pse": false
    },
    "sol_user": "20123456789VENTAS01",
    "has_sol_password": false,
    "soap_url": null,
    "ose": {
      "username": null,
      "has_password": false
    },
    "sunat_api": {
      "client_id": "8c1f2a9e-0b6d-4c1e-9f3a-2d7e5b4a1c90",
      "has_client_secret": true
    },
    "has_certificate": false,
    "certificate": null,
    "pse": {
      "enabled": false,
      "provider": null,
      "pse_provider_id": null,
      "user_pse": null,
      "has_password": false,
      "has_credentials": false,
      "url_signature_pse": null,
      "url_send_cdr_pse": null,
      "url_login_pse": null,
      "client_id_pse": null
    },
    "ready_for_production": {
      "ok": false,
      "missing": [
        {
          "code": "certificate",
          "message": "Suba el certificado digital (.pfx) de la empresa."
        },
        {
          "code": "sol_credentials",
          "message": "Faltan el usuario secundario SOL y su clave."
        }
      ]
    },
    "warnings": [
      {
        "code": "demo_documents",
        "message": "Hay documentos creados en demo: bórrelos para evitar conflictos en producción.",
        "types": [
          {
            "description": "Factura/Boleta o Nota de Crédito o Nota de Débito",
            "count": 12
          }
        ]
      }
    ]
  }
}

403 — Usuario no administrador

{
  "success": false,
  "message": "Solo un administrador puede gestionar este recurso."
}

Pruébalo

Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.