DEHU

DEHU

Conecta tus aplicaciones con funciones DEHU.

Parámetros en la cabecera HTTP

  • Authorization (caracteres): Autorización de la API. Ejemplo: Bearer {token}
  • X-Cert-Secret (caracteres) : Clave secreta asociada al certificado del cliente.

URL base

https://api.saltra.es/api/v4/dehu

Errores

Los errores recibidos en la API del DEHU o errores de validación.

  • success (booleano) : La respuesta "true" cuando todo esta correcto, y "false" cuando hay errores.
  • message (caracteres) : El mensaje de la respuesta.
  • errors (arreglo) : Los errores capturados en la API, ya sea del DEHU o errores de validación.
    • dehu: Errores relacionados con el DEHU.
    • regimen: Errores de validación.
  • maintenance (booleano) : Cuando el DEHU se encuentra en mantenimiento.

Respuesta

Respuesta
{
  "success": false,
  "message": "Página no operativa, inténtelo de nuevo más tarde. StatusCode: 500",
  "status": 500,
  "data": [],
  "errors": {
    "dehu": [
      "Página no operativa, inténtelo de nuevo más tarde. StatusCode: 500"
    ]
  },
  "maintenance": true
}

Limitaciones

Está limitada a 60 peticiones por minuto por usuario en Saltra. Saltra incluye en los headers de respuesta los valores X-Ratelimit-Limit y X-Ratelimit-Remaining.

  • X-Ratelimit-Limit (número entero): Número máximo de peticiones permitidas por minuto. Para usuarios autenticados, el límite se aplica por usuario y ruta; para no autenticados, por IP.
  • X-Ratelimit-Remaining (número entero): Peticiones que aún puedes realizar dentro de la ventana de un minuto antes de alcanzar el límite.

Notificaciones Pendientes

Parámetros

  • page (número entero) : Número de página actual, por defecto es 1.
  • limit (número entero) : Registros por petición, opcional; por defecto y como límite 50 registros.
  • titularNif (caracteres) : NIF del titular, opcional.
  • startDate: Fecha de inicio en formato Y-m-d, opcional.
  • endDate: Fecha de fin en formato Y-m-d, opcional.
GET /notifications-pending
{
  "page": 1,
  "startDate":"2025-01-01",
  "endDate":"2025-01-02"
}

Respuesta

  • sentReference: Identificador de la notificación.
Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "count": 50,
    "total": 51,
    "limit": 50,
    "page": 1,
    "items":[
      {
        "emitterEntity": "Tesoreria General de la Seguridad Social",
        "emitterSourceEntity": "Ministerio de Inclusión, Seguridad Social y Migraciones",
        "nifTitular": "B19994999",
        "sentReference": "446dee88a09c99995754f4d68dc7weq3ea3c909873991",
        "identifier": "N259998999",
        "concept": "REGIMENES SEG. SOCIAL OBLIGADOS A RED / 2101V0999999990999 / PROVIDENCIA DE APREMIO",
        "description": null,
        "postalDelivery": false,
        "availabilityDate": "2025-10-05T00:03:49+02:00",
        "expirationDate": "2025-10-16T23:59:59+02:00",
        "finalDate": null,
        "bondType": "DESTINATARIO",
        "notificationPriority": "NORMAL",
        "unsynchronizedAppearance": null,
        "assuranceLevel": "low" 
      }
    ]
  }
}

Notificaciones Realizadas

Parámetros

  • page (número entero) : Número de página actual, por defecto es 1.
  • limit (número entero) : Registros por petición, opcional; por defecto y como límite 50 registros.
  • titularNif (caracteres) : NIF del titular, opcional.
  • startDate: Fecha de inicio en formato Y-m-d, opcional.
  • endDate: Fecha de fin en formato Y-m-d, opcional.
GET /notifications-done
{
  "page": 1,
  "startDate":"2025-01-01",
  "endDate":"2025-01-02"
}

Respuesta

  • sentReference: Identificador de la notificación.
Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "count": 50,
    "total": 51,
    "limit": 50,
    "page": 1,
    "items":[
      {
          "emitterEntity": "Tesoreria General de la Seguridad Social",
          "emitterSourceEntity": "Ministerio de Inclusión, Seguridad Social y Migraciones",
          "vinculoReceptor": "TITULAR",
          "nifTitular": "B21999999",
          "sentReference": "446dee88a09c99995754f4d68dc7weq3ea3c909873991",
          "state": "ACEPTADA",
          "identifier": "N259993999",
          "concept": "REGIMENES SEG. SOCIAL OBLIGADOS A RED / 2190A4525099999999 / RESOLUCION ALTAS/BAJAS (RED)",
          "postalDelivery": false,
          "availabilityDate": "2025-10-10T01:28:53+02:00",
          "expirationDate": "2025-10-21T23:59:59+02:00",
          "finalDate": "2025-10-10T08:26:02+02:00",
          "bondType": "DESTINATARIO",
          "hasAnnexes": false,
          "notificationPriority": "NORMAL",
          "assuranceLevel": "low"
      }
    ]
  }
}

Comunicaciones

Parámetros (filtros)

  • page (número entero) : Número de página actual, por defecto es 1.
  • limit (número entero) : Registros por petición, opcional; por defecto y como límite 50 registros.
  • titularNif (caracteres) : NIF del titular, opcional.
  • startDate: Fecha de inicio en formato Y-m-d, opcional.
  • endDate: Fecha de fin en formato Y-m-d, opcional.
GET /communications
{
  "page": 1,
  "startDate":"2025-01-01",
  "endDate":"2025-01-02"
}

Respuesta

  • sentReference: Identificador de la notificación.
Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "count": 50,
    "total": 51,
    "limit": 50,
    "page": 1,
    "items":[
      {
        "emitterEntity": "Tesoreria General de la Seguridad Social",
        "emitterSourceEntity": "Ministerio de Inclusión, Seguridad Social y Migraciones",
        "vinculoReceptor": "",
        "nifTitular": "99936799A",
        "sentReference": "446dee88a09c99995754f4d68dc7weq3ea3c909873991",
        "state": "PENDIENTE",
        "identifier": "C59999999",
        "concept": "REGIMENES SEG. SOCIAL OBLIGADOS A RED / 2101D2999942419999 / COMUNICACIÓN CON DESTINO NACIONAL",
        "postalDelivery": false,
        "availabilityDate": "2025-10-09T00:02:48+02:00",
        "finalDate": null,
        "document": [],
        "bondType": "DESTINATARIO",
        "hasAnnexes": false
      }
    ]
  }
}

Obtener detalle de una notificación realizada

Parámetros (filtros)

  • id (caracteres) : Identificador de la notificación (sentReference).
  • duplicate (número) : Opcional. obtiene el "content" del document en base64 si lo tiene.
  • voucher (número) : Opcional. obtiene el "content" del resguardo en base64 si lo tiene.
GET /notification-done
{
  "id": "446dee88a09c99995754f4d68dc7weq3ea3c909873991"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "emitterEntity": "Tesoreria General de la Seguridad Social",
    "emitterSourceEntity": "Ministerio de Inclusión, Seguridad Social y Migraciones",
    "nifReceptor": "99999962X",
    "nameReceptor": "JOSE JUAN PEREZ",
    "receiver": {
        "nif": "99999962X",
        "name": "JOSE JUAN PEREZ",
        "dir3Code": null,
        "direCode": null
    },
    "nifTitular": "B99999999",
    "dir3Code": null,
    "direCode": null,
    "cantAnnexes": 0,
    "sentReference": "446dee88a09c99995754f4d68dc7weq3ea3c909873991",
    "state": "ACEPTADA",
    "identifier": "N999609999",
    "concept": "REGIMENES SEG. SOCIAL OBLIGADOS A RED / 99999999904 / RECLAMACIÓN DE DEUDA",
    "description": null,
    "availabilityDate": "2025-10-01T01:37:22+02:00",
    "expirationDate": "2025-10-12T23:59:59+02:00",
    "finalDate": "2025-10-01T10:29:32+02:00",
    "document": {
        "publicMetadata": null,
        "privateMetadata": null,
        "documentLink": null,
        "name": "SINT_FGDE_999999999.pdf",
        "mimeType": "application/pdf",
        "content":null
    },
    "bondType": "DESTINATARIO",
    "unsuccessfulState": null,
    "hasAnnexes": false,
    "siaCode": "2997999",
    "siaDenomination": "NOTIFICACIONES ELECTRÓNICAS TGSS",
    "voucher": {
        "mimeType": "application/pdf",
        "name": "Resguardo_xxx.pdf",
        "enabled": true,
        "content":null
    }
  }
}

Obtener duplicado de una notificación

Parámetros (filtros)

  • id (caracteres) : Identificador de la notificación (sentReference).
GET /notification-document
{
  "id": "446dee88a09c99995754f4d68dc7weq3ea3c909873991"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "content": "base64",
    "name": "SINT_FGDE_999999999.pdf",
    "mimeType": "application/pdf",
    "contentType": "application/pdf",
    "privateMetadata":null
  }
}

Obtener resguardo de una notificación

Parámetros (filtros)

  • id (caracteres) : Identificador de la notificación (sentReference).
GET /notification-voucher
{
  "id": "446dee88a09c99995754f4d68dc7weq3ea3c909873991"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "content": "base64",
    "name": "Resguardo_1xxbbb9x.pdf",
    "mimeType": "application/pdf",
    "contentType": "application/pdf",
    "enabled": true,
  }
}
Duplicado de llamamientoErrores