Aller au contenu principal

internal_error

Statut HTTP : 500 · Rejouable : oui — après un délai, avec la même clé d'idempotence.

Cause​

Une erreur inattendue s'est produite côté Pesia. Ce n'est pas un problème avec votre requête : rien dans son contenu ne peut être corrigé pour l'éviter.

Réponse​

HTTP/1.1 500 Internal Server Error
Content-Type: application/problem+json

{
  "type": "https://docs.pesia.fr/partner/errors/internal_error",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "An unexpected error occurred.",
  "code": "internal_error",
  "instance": "/partner/v1/payroll-batches",
  "correlationId": "01J9Z6Q7K3M4N5P6R7S8T9V0W1",
  "timestamp": "2026-08-14T09:12:44.318Z"
}

Le detail est toujours ce message générique sur les réponses 5xx : aucun détail interne n'est exposé. L'information exploitable est le correlationId, qui identifie la requête dans nos journaux.

Extensions​

Aucune — seuls les champs standard ci-dessus.

Que faire​

  • Journaliser le correlationId. C'est la seule clé qui permet de retrouver la requête côté Pesia :

    curl -s https://api.pesia.fr/partner/v1/payroll-batches \
      -H "Authorization: Bearer $TOKEN" \
      -H "Idempotency-Key: $(uuidgen)" \
      -H 'Content-Type: application/json' \
      -d @lot.json \
    | jq -r '.correlationId // "aucun"'

  • Rejouer après un délai, avec backoff exponentiel, en réutilisant la même clé Idempotency-Key : le traitement a pu aboutir partiellement, l'idempotence garantit qu'un rejeu ne crée pas de doublon.

  • Si l'erreur persiste au-delà de quelques minutes, contactez votre interlocuteur Pesia (partenaires@pesia.fr) en joignant le correlationId et l'horodatage.

Voir aussi : Idempotence · Tous les codes d'erreur