Saltar al contenido
Facturador

Configurar envío directo a SUNAT

PUT /api/company/sunat-config

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

Configura el modo de envío y las credenciales. Este ejemplo deja el envío directo a SUNAT con el usuario secundario SOL. Es edición parcial: envía solo lo que cambias.

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). data trae la configuración completa (igual que Ver configuración SUNAT).

Cuerpo (JSON):

Campo Tipo Obligatorio Descripción / valores permitidos
soap_send_id string No 01 Sunat, 02 Ose, 04 OseSendfact. Ver la tabla de modos de envío.
sunat_sol_username string (máx. 255) No Usuario secundario SOL: RUC de la empresa + usuario (p. ej. 20123456789VENTAS01).
sunat_sol_password string (máx. 255) No Clave SOL. Solo escritura. Si no se envía se conserva la guardada; si cambias el usuario debes enviar su clave.
ose_username string (máx. 255) No Usuario del OSE (modos 02 y 04).
ose_password string (máx. 255) No Clave del OSE. Solo escritura. Si no se envía se conserva la guardada.
soap_url string (URL, máx. 255) No URL del servicio del OSE (obligatoria en modo 02 para producción).
soap_username / soap_password string No Alias: se guardan como usuario/clave SOL en modo 01 o del OSE en modos 02/04. Con PSE responden 422.
sunat_client_id string (máx. 255) No Client ID de la aplicación API de SUNAT (guías de remisión, SIRE).
sunat_client_secret string (máx. 255) No Client Secret. Solo escritura. Va en pareja con sunat_client_id.
soap_type_id string No 01 (demo) o 02 (producción). Solo para cambiar de entorno: ver Pasar a producción y Volver a demo.
environment string No Alias de soap_type_id: demo o production.
confirm_production boolean Para pasar a producción true para confirmar el paso a producción.
confirm_demo boolean Para volver a demo true para confirmar el regreso a demo.

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.

Reglas:

  • Edición parcial: solo cambia lo que envías; lo demás se conserva. Un campo de clave vacío o ausente conserva la clave guardada.
  • Las claves (sunat_sol_password, ose_password, sunat_client_secret) son de solo escritura: la respuesta solo dice si existen (has_*).
  • En modo 01 (Sunat) el envío de comprobantes usa el usuario y la clave SOL.
  • Si la empresa ya está en producción, un cambio que la deje sin poder emitir (p. ej. pasar a OSE sin URL) responde 409 con los faltantes que agrega.
  • Al cambiar credenciales se invalidan los tokens de SUNAT guardados; el siguiente envío pide uno nuevo.

Errores:

  • 403 si el usuario no es administrador.
  • 403 si el proveedor del sistema bloqueó la configuración del entorno de la empresa (editable: false): no se pueden cambiar entorno, modo de envío, credenciales SOL/OSE ni el certificado.
  • 422 {success: false, message: {campo: [errores]}} si falla la validación de campos. (usuario SOL sin el RUC de la empresa, usuario nuevo sin su clave, OSE sin usuario/clave, Client ID sin Client Secret, cuerpo vacío).
  • 409 con missing si la empresa está en producción y el cambio la dejaría sin poder emitir.
  • 401 sin token o con un token inválido.

Cuerpo

Content-Type: application/json

{
  "soap_send_id": "01",
  "sunat_sol_username": "20123456789VENTAS01",
  "sunat_sol_password": "********"
}

Respuestas

200 — Guardado

{
  "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
          }
        ]
      }
    ]
  },
  "message": "Configuración SUNAT actualizada."
}

422 — Usuario SOL inválido

{
  "success": false,
  "message": {
    "sunat_sol_username": [
      "Debe ser el RUC de la empresa seguido del usuario SOL. Ejemplo: 20123456789USUARIO"
    ]
  }
}

422 — Usuario nuevo sin clave

{
  "success": false,
  "message": {
    "sunat_sol_password": [
      "Ingrese la clave SOL del nuevo usuario."
    ]
  }
}

403 — Usuario no administrador

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

403 — Configuración bloqueada

{
  "success": false,
  "message": "El proveedor del sistema bloqueó el cambio de entorno, modo de envío y credenciales SOL/OSE de esta empresa. Campos no permitidos: soap_send_id."
}

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.