Actes de notoriété

Ouvrez et suivez une demande d’acte de notoriété depuis votre CRM / produit via la Partner API Allaw.

Base path : /v1/notorieties

Qu’est-ce qu’on intègre ?

Un acte de notoriété établit la qualité d’héritier (souvent pour débloquer des comptes, assurances, formalités successorales).
Côté partenaire, vous :

Créez un dossier minimal (demandeur)
Enrichissez les données (défunt, héritiers…)
Attachez des pièces (URLs HTTPS en V1)
Suivez le status jusqu’à la clôture

Allaw orchestre le traitement notarial.

Architecture

Couche	Responsabilité
Votre produit	UX, pièces, `Idempotency-Key`, polling / webhooks (à venir)
Partner API	Contrat stable, auth, rate limit, état `status`, isolation par clé
Allaw	Traitement notarial, validation, acte

Parcours d’intégration (happy path)

Étapes recommandées côté CRM

Générer une Idempotency-Key stable liée à votre dossier métier (ex. crm-case-42-notoriety)
POST création avec au minimum data.requester
Stocker l’id UUID renvoyé
Uploader / référencer les pièces dès qu’elles sont prêtes
Poller GET /v1/notorieties/:id (webhooks prévus plus tard)
Afficher le status à l’utilisateur / ops

Cycle de vie — statuts

Statut initial à la création : created.

Status	Signification partenaire
`created`	Dossier ouvert côté Partner API
`processing`	Traitement / complément en cours
`awaiting_notary_validation`	En attente de validation notaire
`completed`	Terminé avec succès
`rejected`	Clôturé sans succès

remarque

En V1, la création pose toujours created. Les transitions suivantes sont gérées par Allaw. Concevez votre UI pour tous les statuts listés.

Endpoints

Méthode	Chemin	Idempotent	Description
`POST`	`/v1/notorieties`	Oui (`Idempotency-Key`)	Créer une demande
`GET`	`/v1/notorieties`	—	Lister (curseur)
`GET`	`/v1/notorieties/:id`	—	Détail
`POST`	`/v1/notorieties/:id/documents`	Oui	Attacher un document
`GET`	`/v1/notorieties/:id/documents`	—	Lister les documents

Tous exigent Authorization: Bearer sk_live_….

Créer une demande

POST /v1/notorieties

Headers

Header	Obligatoire	Description
`Authorization`	Oui	`Bearer sk_live_…`
`Idempotency-Key`	Oui	≤ 256 car. ; unique par intention
`Content-Type`	Oui	`application/json`
`X-Correlation-Id`	Non	Traçabilité cross-système

Résolution de l’organisation

Body — minimal

Seul data.requester est obligatoire à la création (passez les autres blocs dès la création si vous les avez).

{
  "data": {
    "requester": {
      "fullName": "Marie Dupont",
      "capacity": "heir",
      "email": "[email protected]"
    }
  }
}

Body — complet

{
  "targetOrganizationId": "org_3EDD2GKNG71h5PXAk266iDk25uK",
  "data": {
    "requester": {
      "fullName": "Marie Dupont",
      "capacity": "heir",
      "email": "[email protected]",
      "phone": "0612345678",
      "birthDate": "1955-06-20",
      "birthPlace": "Lyon"
    },
    "deceased": {
      "fullName": "Jean Dupont",
      "birthDate": "1950-03-12",
      "birthPlace": "Paris",
      "deathDate": "2026-01-15",
      "lastAddress": "12 rue de Rivoli, 75001 Paris"
    },
    "heirs": [
      {
        "fullName": "Marie Dupont",
        "relationship": "child",
        "email": "[email protected]",
        "birthDate": "1955-06-20"
      }
    ],
    "purpose": "Succession — ouverture des comptes bancaires",
    "jurisdictionPostalCode": "75001"
  }
}

Champs `data`

Champ	Obligatoire	Description
`requester`	Oui	Demandeur
`requester.fullName`	Oui	Nom complet
`requester.capacity`	Oui	`heir` \| `notary` \| `lawyer` \| `other`
`requester.email`	Oui	Email de contact
`requester.phone`	Non	`0-9 + . -` espaces, 8–20 car.
`requester.birthDate`	Non	ISO date
`requester.birthPlace`	Non	Lieu de naissance
`deceased`	Non	Identité du défunt (+ `deathDate`, `lastAddress`)
`heirs[]`	Non	Héritiers (`relationship` : `spouse` \| `child` \| `parent` \| `sibling` \| `other`)
`purpose`	Non	Objet de la demande (≤ 500)
`jurisdictionPostalCode`	Non	Code postal 5 chiffres
`targetOrganizationId`	Non	Override organisation Allaw (`org_…` fourni à l’onboarding)

Réponses

HTTP	Cas
`201`	Création effective
`200`	Rejeu idempotent (même `Idempotency-Key`)
`400`	Body / header invalide, ou conflit de clé d’idempotence
`401`	Auth
`429`	Rate limit

Exemple réponse

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "created",
  "target_organization_id": "org_3EDD2GKNG71h5PXAk266iDk25uK",
  "data": {
    "requester": {
      "fullName": "Marie Dupont",
      "capacity": "heir",
      "email": "[email protected]"
    }
  },
  "created_at": "2026-07-22T14:00:00.000Z",
  "updated_at": "2026-07-22T14:00:00.000Z"
}

curl

curl -sS https://naas.allaw.fr/v1/notorieties \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: crm-case-42-notoriety" \
  -H "X-Correlation-Id: crm-req-42" \
  -d '{
    "data": {
      "requester": {
        "fullName": "Marie Dupont",
        "capacity": "heir",
        "email": "[email protected]"
      },
      "deceased": {
        "fullName": "Jean Dupont",
        "deathDate": "2026-01-15"
      },
      "purpose": "Succession — ouverture des comptes bancaires",
      "jurisdictionPostalCode": "75001"
    }
  }'

Consulter / lister

Détail

GET /v1/notorieties/:id

:id = UUID
Ressource d’une autre clé → 404 (pas de fuite d’existence cross-tenant)

Liste paginée

GET /v1/notorieties?limit=20&cursor=…

Query	Défaut	Description
`limit`	`20`	1–100
`cursor`	—	Curseur opaque renvoyé dans `next_cursor`

{
  "data": [ /* NotorietyResponseDto[] */ ],
  "next_cursor": "eyJ…"
}

Quand next_cursor est null, fin de liste.

curl -sS "https://naas.allaw.fr/v1/notorieties?limit=20" \
  -H "Authorization: Bearer sk_live_…"

curl -sS "https://naas.allaw.fr/v1/notorieties?limit=20&cursor=CURSOR" \
  -H "Authorization: Bearer sk_live_…"

Documents

En V1, pas d’upload multipart : vous passez une URL HTTPS accessible (stockage partenaire / CDN signé).

Attacher

POST /v1/notorieties/:id/documents

Headers : Authorization, Idempotency-Key (obligatoire), Content-Type.

{
  "kind": "death_certificate",
  "filename": "acte-deces.pdf",
  "url": "https://files.partner.example/docs/acte-deces.pdf",
  "content_type": "application/pdf"
}

Types `kind`

`kind`	Usage typique
`identity`	Pièce d’identité
`death_certificate`	Acte de décès
`family_record_book`	Livret de famille
`proof_of_address`	Justificatif de domicile
`power_of_attorney`	Procuration
`other`	Autre

Réponse document

{
  "id": "…",
  "notoriety_id": "…",
  "kind": "death_certificate",
  "filename": "acte-deces.pdf",
  "url": "https://files.partner.example/docs/acte-deces.pdf",
  "content_type": "application/pdf",
  "status": "received",
  "created_at": "2026-07-22T14:05:00.000Z"
}

Lister

GET /v1/notorieties/:id/documents → tableau de documents.

# Attacher
curl -sS https://naas.allaw.fr/v1/notorieties/$ID/documents \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: crm-case-42-doc-death" \
  -d '{
    "kind": "death_certificate",
    "filename": "acte-deces.pdf",
    "url": "https://files.partner.example/docs/acte-deces.pdf",
    "content_type": "application/pdf"
  }'

# Lister
curl -sS https://naas.allaw.fr/v1/notorieties/$ID/documents \
  -H "Authorization: Bearer sk_live_…"

:::info Roadmap Upload binaire (S3 / multipart) prévu. Gardez une abstraction « pièce » côté CRM pour basculer sans changer votre métier. :::

Idempotence — pièges fréquents

À faire	À éviter
Une clé par intention métier	Réutiliser K pour un body différent
Retry réseau avec la même K	Générer un UUID à chaque retry
Clé dérivée de votre `case_id`	Clé aléatoire non persistée

Voir aussi Idempotence.

Erreurs utiles

Status	Exemple	Action
`400`	`Idempotency-Key header is required`	Ajouter le header
`400`	Conflit d’idempotence	Changer de clé ou investiguer
`401`	Unauthorized	Vérifier `Bearer sk_live_…`
`404`	Notoriety not found	Mauvais id ou autre tenant
`429`	Rate limit	Backoff + jitter

Body : application/problem+json + correlationId — voir Erreurs.

Checklist go-live partenaire

Clé sk_live_… stockée côté serveur uniquement
default_organization_id renseigné (ou override systématique)
Idempotency-Key stable par dossier CRM
Mapping UI des 5 status
Hébergement HTTPS des pièces + kind corrects
Propagation de X-Correlation-Id dans vos logs
Gestion 429 / retries
Suivi status.allaw.fr (groupe Types d’actes)

Référence interactive

Schémas OpenAPI à jour : naas.allaw.fr/docs (tag notorieties).

Qu’est-ce qu’on intègre ?​

Architecture​

Parcours d’intégration (happy path)​

Étapes recommandées côté CRM​

Cycle de vie — statuts​

Endpoints​

Créer une demande​

Headers​

Résolution de l’organisation​

Body — minimal​

Body — complet​

Champs data​

Réponses​

Exemple réponse​

curl​

Consulter / lister​

Détail​

Liste paginée​

Documents​

Attacher​

Types kind​

Réponse document​

Lister​

Idempotence — pièges fréquents​

Erreurs utiles​

Checklist go-live partenaire​

Référence interactive​