Obtenir le BillTo proposé pour un client (pré-remplissage émission facture)

GET

/v1/guests/{id}/bill-to-proposal

curl --request GET \
  --url https://example.com/v1/guests/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/bill-to-proposal \
  --header 'X-API-Key: <X-API-Key>'

Retourne le BillTo dérivé depuis le profil de facturation PRO du client (ACL composition). IMPORTANT : il s’agit d’une PROPOSITION. Le snapshot BillTo figé dans la facture est construit à l’émission depuis le body HTTP (l’opérateur peut modifier). NF203 garanti. Si le client n’a pas de profil PRO, retourne un BillTo consumer (résidence). Si la TVA UE (eu_business_vatid) n’est pas vérifiée (VIES), retourne fr_business + warning.

Authorizations

• ApiKeyAuth
• BearerAuth

Parameters

Path Parameters

id

required

string format: uuid

UUID du profil guest

Responses

200

BillTo proposé (peut inclure un warning)

Media type application/json

object

data

required

object

billTo

required

object

type

required

string

Allowed values: guest organization agency ota

name

required

string

address

string

nullable

country

ISO 3166-1 alpha-2

string

nullable

siret

SIRET 14 chiffres

string

nullable

vatNumber

N° TVA intracom

string

nullable

vatRegime

required

Régime TVA effectif dérivé (conservatif : eu_business_vatid non vérifié → fr_business)

string

Allowed values: consumer fr_business fr_business_exempt eu_business_vatid non_eu

warning

Présent si la dérivation a rétrogradé un régime TVA (ex. TVA UE non vérifiée). À afficher à l’opérateur avant émission.

string

nullable

Example

{
  "data": {
    "billTo": {
      "type": "guest",
      "vatRegime": "consumer"
    }
  }
}

401

Non authentifié

Media type application/json

object

code

required

Code machine de l’erreur

string

message

required

Message lisible

string

origin

Origine domaine de l’erreur (optionnel)

object

boundedContext

string

module

string

status

required

integer

traceId

required

Identifiant de corrélation pour le support

string

Example

{
  "code": "RESERVATION_NOT_FOUND",
  "message": "Réservation introuvable",
  "status": 404
}

403

Permission refusée (guest.read)

Media type application/json

object

code

required

Code machine de l’erreur

string

message

required

Message lisible

string

origin

Origine domaine de l’erreur (optionnel)

object

boundedContext

string

module

string

status

required

integer

traceId

required

Identifiant de corrélation pour le support

string

Example

{
  "code": "RESERVATION_NOT_FOUND",
  "message": "Réservation introuvable",
  "status": 404
}

404

Profil guest introuvable

Media type application/json

object

code

required

Code machine de l’erreur

string

message

required

Message lisible

string

origin

Origine domaine de l’erreur (optionnel)

object

boundedContext

string

module

string

status

required

integer

traceId

required

Identifiant de corrélation pour le support

string

Example

{
  "code": "RESERVATION_NOT_FOUND",
  "message": "Réservation introuvable",
  "status": 404
}

409

Profil anonymisé — BillTo non disponible (RGPD art.17)

Media type application/json

object

code

required

Code machine de l’erreur

string

message

required

Message lisible

string

origin

Origine domaine de l’erreur (optionnel)

object

boundedContext

string

module

string

status

required

integer

traceId

required

Identifiant de corrélation pour le support

string

Example

{
  "code": "RESERVATION_NOT_FOUND",
  "message": "Réservation introuvable",
  "status": 404
}