Referencia API REST

Endpoints de integracion

Base URL: https://oportuno.pruebasoportuno.nom.pe/api/integrations/v1

Autenticacion

Todas las llamadas usan token Bearer generado desde el panel Empresa, en el modulo Integraciones / Tokens API.

Authorization: Bearer TU_TOKEN_API
Accept: application/json
Content-Type: application/json

GET /branches

Lista los locales activos de la empresa autenticada.

Permiso requerido

branches:read

GET /complaints

Lista reclamos y quejas de la empresa autenticada con filtros por estado, tipo y fecha.

Permiso requerido

complaints:read

POST /complaints

Registra un reclamo o queja desde un sistema externo.

Permiso requerido

complaints:create

GET /complaints/{code}

Consulta un caso por código único.

Permiso requerido

complaints:read

PATCH /complaints/{code}

Actualiza estado, prioridad o responsable del caso.

Permiso requerido

complaints:update

GET /reports/complaints-summary

Devuelve resumen de reclamos por estado y tipo.

Permiso requerido

reports:read

POST /webhooks/test

Registra un evento de prueba para webhooks activos.

Permiso requerido

webhooks:test

Ejemplo de creacion

Registrar reclamo por API

curl -X POST "https://oportuno.pruebasoportuno.nom.pe/api/integrations/v1/complaints" \
  -H "Authorization: Bearer TU_TOKEN_API" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "reclamo",
    "consumer_document_type": "DNI",
    "consumer_document_number": "12345678",
    "consumer_name": "Cliente de prueba",
    "consumer_email": "cliente@example.com",
    "product_or_service": "Servicio contratado",
    "description": "Detalle del caso registrado desde sistema externo.",
    "consumer_request": "Pedido del consumidor registrado por API."
  }'