Restofy Docs
Proveedores de facturación POST

Probar conexión con el proveedor

POST /api/electronic-providers/validate-connection

Descripción

Verifica en tiempo real si el token conecta correctamente con el proveedor.

Detalles

Consulta al proveedor con la credencial indicada y confirma si la conexión funciona. Si funciona, devuelve las resoluciones de numeración registradas para ese negocio como evidencia. Si no envías un token o un ID de software nuevos, prueba con los ya guardados del proveedor indicado. Falla con un mensaje claro si el token no es válido o si el tipo de proveedor no admite esta prueba.

Permisos requeridos

admin.module

Request

Nombre Tipo Requerido Reglas
electronicProviderTypeId int
min_value:1
token string No
max:5000
idSoftware string No
max:50
electronicProviderUuid string No
min:36 max:36

Ejemplo de request

curl -X POST https://restofy.pro/api/electronic-providers/validate-connection \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -H "X-Tenant-Key: <tenantKey>" \
  -d '{
    "electronicProviderTypeId": 1
}'

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-09-08T16:35:34Z
HTTP 200

Request

{
    "electronicProviderTypeId": 1,
    "token": "***",
    "idSoftware": "SOFT-001"
}

Response

{
    "success": true,
    "message": "Conexión exitosa",
    "data": {
        "resolutions": [
            {
                "resolutionNumber": "TEST-0001",
                "prefix": "SETT",
                "fromNumber": 1,
                "toNumber": 5000,
                "validFrom": null,
                "validTo": null,
                "technicalKey": "stub-technical-key"
            }
        ]
    }
}