Portal de Clientes

El portal de clientes permite a tus clientes ver en una sola vista:

• Facturas pendientes de pago
• Facturas pagadas
• Anticipos (montos a favor)

Además de la consulta, el portal permite a los clientes está conectado con la pasarela de pagos de forma directa. Para integrarlo en tu sitio web, solo debes obtener la URL única del portal por cliente a través de nuestra API y redirigir al usuario (o abrir el enlace en una nueva pestaña).

Conexión vía API

Endpoint

Envia una solicitud a GET /api/v1/collection-clients/tax-id

• taxId: (código tributario del cliente; en Chile, RUT sin puntos y con guión, ej: 99999999-9). Requerido
• signUrls 0 para URLs normales (Por defecto), 1: URLs firmadas digitalmente para mayor seguridad.
  En caso de tener nivel de seguridad alta si la url no viene firmada tu cliente no podrá usar el portal Opcional

Respuesta exitosa (200)

El cuerpo sigue la estructura estándar de la API; en data viene el cliente con la URL del portal:

{
  "status": true,
  "data": {
    "id": "22879",
    "name": "Nombre del cliente",
    "taxId": "11111111-1",
    "url": "https://app.duemint.com/portal?clientId=22879&portalKey=...",
    ...
  }
}

• data.url: URL del portal para ese cliente. Es la que debes usar para enviar al usuario (redirección o enlace).

Si el cliente no existe o no pertenece a la empresa del token, la API responde sin éxito (404)

Flujo en tu aplicación

1. En tu sistema tienes el tax_id del cliente (ej. RUT).
2. Llamas a GET /api/v1/collection-clients/tax-id?taxId=<tax_id> .
3. Si la respuesta es exitosa, tomas data.url.
4. Rediriges al usuario a esa URL (o la abres en nueva pestaña). Si es que quieres implementarlo en un iframe debes hablar con nuestro soporte técnico primero.
5. El usuario llega al Portal de Clientes de Duemint.

Diagrama de flujo

sequenceDiagram
    participant U as Usuario final
    participant Web as Tu página web
    participant API as API Duemint
    participant Portal as Portal de clientes Duemint

    Note over U,Portal: Obtención de la URL del portal

    U->>Web: Accede a tu página web
    Web->>Web: Obtienes tax_id del cliente
    Web->>API: GET /api/v1/.../taxId=XXXXXXXX-X<br/>Auth: Bearer JWT<br/>X-DUEMINT-COMPANY-ID
    
    API->>API: Valida JWT y company_id
    API->>API: Busca cliente por company + taxId

    alt [Cliente encontrado]
        API->>API: Construye URL del portal
        API->>Web: 200 { status: true, data: { url: "..." } }
        Web->>Web: Guarda data.url
        Web->>Portal: Redirección o enlace a data.url
        Portal->>U: Muestra portal de clientes
    else [Cliente no encontrado / no activo]
        API->>Web: 404 
        Web->>U: Mensaje "Cliente no encontrado"
    end