Objet « partenaire » « partner » – RetailForce

Cet article traite de l’objet « partenaire » au sein de l’objet « document ».

Une description complète du RetailForce DOM (Document Object Model), ainsi qu’une description des différents éléments, sont disponibles dans la section « Téléchargements » du RetailForce website (Documentation du modèle d’objet.pdf) dans le répertoire de la version correspondante.

L’objet « parter » contient des informations sur les partenaires (commerciaux) respectifs de l’entreprise émettrice du document. Il peut s’agir, par exemple, de partenaires externes tels que des clients ou des fournisseurs, mais aussi de « clients » internes, comme une succursale particulière de l’entreprise à laquelle des marchandises sont expédiées.

objet « partner »

L’objet « partenaire » suivant contient des exemples de données.

"partner": {
  "id": "2241247",
  "caption": "Jane Doe",
  "isBusiness": true,
  "partnerType": "[0] = Customer",
  "partnerClassification": "Customer",
  "vatNumber": null,
  "taxNumber": null,
  "companyIdentification": [
    {
      "type": "[12] = LocationIdentification",
      "identification": "1234567890ABC"
    }
  ],
  "identificationType": "passport",
  "partnerIdentification": null,
  "additionalIdentifications": null,
  "addresses": [
    {
      "addressType": "[1] = BillingAddress,
      "street": "Hintere Zollamtsstraße",
      "streetNumber": "4",
      "postalCode": "1030",
      "city": "Wien",
      "community": null,
      "countryCode": "AUT"
    }
  ],
  "addressType": "[1] = BillingAddress,
  "street": "Hintere Zollamtsstraße",
  "streetNumber": "4",
  "postalCode": "1030",
  "city": "Wien",
  "community": null,
  "countryCode": "AUT"
},

L’objet « partenaire » contient les informations suivantes.

Informations dans la colonne « Type » :

M … obligatoire / requis
M* … obligatoire / requis dans certains pays ou sous certaines conditions
R ... recommandé
O... facultatif

Éléments		Type	Description
ID		M	Identifiant du partenaire. Il peut s'agir, par exemple, du numéro de client ou de l'ID.
caption		O	Désignation des partenaires (par exemple, nom, raison sociale).
IsBusiness		M*	Indique si la transaction est une transaction B2B (true) ou une transaction B2C (faux). Informations sur le pays : France : informations obligatoires Portugal : informations obligatoires Québec/Canada : informations obligatoires
PartnerType		M*	Type/catégorie de partenaire (commercial) (liste enum). Valeur courante : [0] = Client [1] = Fournisseur Informations sur le pays : Portugal : informations obligatoires
PartnerClassification		O	Classification du partenaire (et non le PartnerType !).
VatNumber		M*	ID de Vat du partenaire (obligatoire pour les transactions B2B).
taxNumber		O	Numéro fiscal du partenaire, par exemple « numéro d'identification fiscale de l'entreprise » (et NON le numéro de Vat !)
companyIdentification		O	Autres informations d’identification du client (B2B) à des fins diverses.
	type	O	Définit le type d’attribut d’ID. Valeurs possibles : [0] = VatNumber, [1] = taxNumber, [2] = Numéro de registre, [3] = Numéro d'identification de l'entreprise, [4] = Classification statistique, [5] = Numéro d'immatriculation au registre du commerce, [6] = service chargé de l'attribution du numéro d'immatriculation au registre du commerce, [7] = Numéro du registre du commerce, [8] = Numéro du bureau des impôts, [9] = Numéro de TVA, [10] = Numéro de TVQ, [11] = Code de routage, [12] = Identifiant de localisation La signification de chaque champ est détaillée dans l’article « Identification de l’entreprise ». Informations par pays : France : le type [12] = LocationIdentification sert à indiquer le numéro SIRET du client ou du partenaire.
	Identification	O	Définit la valeur réelle de l’attribut « ID » (par exemple, le SIRET en France lorsque le type [12] = LocationIdentification est spécifié).
IdentificationType		M*	manière dont l’identité du partenaire a été vérifiée. Enum PartnerIdentificationType : OfficialDocument Autre Passeport Certificat de résidence
PartnerIdentification		M*	Identification du partenaire – si cette option est définie, la propriété IdentificationType doit également être définie.
AdditionalIdentifications		O	Fonctionnalités d'identification supplémentaires à des fins diverses.
	lotteryId	O	Identifiant de loterie personnel attribué à un client en Italie. Il est obligatoire pour participer à la « loterie différée » (« Lotteria Differita ») de la « Lotteria degli Scontrini » (« loterie des tickets de caisse »). Informations par pays : Italie : si un client souhaite participer à la « Lotteria Differita », son ID personnel doit être saisi dans ce champ.
	additionalProp1	O	Caractéristiques supplémentaires de l’ID à des fins diverses.
	additionalProp2	O	Fonctionnalités d'ID supplémentaires à des fins diverses.
	additionalProp3	O	Fonctionnalités d'ID supplémentaires à des fins diverses.
adresses		O/M*	Permet de saisir plusieurs adresses ou des adresses supplémentaires. Si une seule adresse doit être fournie, utilisez le champ général « Document.Partner ». Remarque : en règle générale, les adresses doivent toujours figurer sur les factures B2B (« documentType » : « [1] = Facture »).
	addressType	O/M*	La propriété « addressType » définie à ce niveau précise le type d’adresse saisie sous « Document.Partner.Addresses ». Les types d’adresse suivants sont disponibles : [1] = BillingAddress, [2] = Adresse de livraison, [3] = Adresse résidentielle, [4] = Siège social, [5] = ServiceRendu Informations sur le pays : Portugal : Spécification des types d’adresse pour les factures B2B au Portugal : [1] = BillingAddress - Obligatoire, [2] = AdresseDeLivraison - Facultatif
	rue	O/M*	Rue Informations sur le pays : Portugal : champ obligatoire Québec : champ obligatoire si un « partenaire » (client) est spécifié. Revenu Québec ne prend en charge que les informations relatives aux clients canadiens.
	streetNumber	O/M*	Numéro de rue Informations sur le pays : Portugal : champ obligatoire Québec : champ obligatoire si un « partenaire » (client) est spécifié. Revenu Québec ne prend en charge que les informations relatives aux clients canadiens.
	PostalCode	O/M*	Code postal Informations sur le pays : Portugal : champ obligatoire Québec : champ obligatoire si un « partenaire » (client) est spécifié. Revenu Québec ne prend en charge que les informations relatives aux clients canadiens. Le code postal doit être au format canadien : A9A9A9 6 caractères 1 caractère (lettre), 1 chiffre, 1 caractère (lettre), 1 chiffre, 1 caractère (lettre), 1 chiffre.
	ville	O/M*	Ville / Commune Informations sur le pays : Portugal : champ obligatoire Québec : champ obligatoire si un « partenaire » (client) est spécifié. Revenu Québec ne prend en charge que les informations concernant les clients canadiens.
	Communauté	O	Dans certains pays (par exemple en Slovénie), ce que l’on appelle la « communauté » fait partie de l’adresse.
	CountryCode	O/M*	Code pays conforme à la norme ISO 3166 alpha-3 (3 caractères). Informations sur le pays : Portugal : champ obligatoire
addressType		O/M*	La propriété « addressType » définie à ce niveau détermine le type d’adresse saisi dans « Document.Partner ». Si vous devez indiquer plusieurs adresses différentes avec des types d’adresse distincts, vous pouvez le faire dans « Document.Partner.Addresses ». Les types d’adresse suivants sont disponibles : [1] = BillingAddress, [2] = Adresse de livraison, [3] = Adresse résidentielle, [4] = Siège social, [5] = Prestation de service Informations sur le pays : Portugal : Spécification des types d’adresse sur les factures B2B au Portugal : [1] = BillingAddress - Obligatoire, [2] = AdresseDeLivraison - Facultatif
rue		O/M*	Rue Informations sur le pays : Portugal : champ obligatoire Québec : champ obligatoire si un « partenaire » (client) est spécifié. Revenu Québec ne prend en charge que les informations concernant les clients canadiens.
streetNumber		O/M*	Numéro de rue Informations sur le pays : Portugal : champ obligatoire Québec : champ obligatoire si un « partenaire » (client) est indiqué. Revenu Québec ne prend en charge que les informations relatives aux clients canadiens.
PostalCode		O/M*	Code postal Informations sur le pays : Portugal : champ obligatoire Québec : champ obligatoire si un « partenaire » (client) est spécifié. Revenu Québec ne prend en charge que les informations relatives aux clients canadiens. Le code postal doit être au format canadien : A9A9A9 6 caractères 1 caractère (lettre), 1 chiffre, 1 caractère (lettre), 1 chiffre, 1 caractère (lettre), 1 chiffre.
ville		O/M*	Ville / Commune Informations sur le pays : Portugal : champ obligatoire Québec : champ obligatoire si un « partenaire » (client) est spécifié. Revenu Québec ne prend en charge que les informations relatives aux clients canadiens.
Communauté		O	Dans certains pays (par exemple en Slovénie), ce qu’on appelle la « communauté » fait partie de l’adresse.
CountryCode		O/M*	Code pays conforme à la norme ISO 3166 alpha-3 (3 caractères). Informations sur le pays : Portugal : champ obligatoire

Cet article a été traduit automatiquement.

objet « partner »

Articles associés