[Shopify Plus] Configurer les blocs de paiement Shopify pour récupérer les numéros d'identification fiscale des destinataires (NIF des Îles Canaries, CPF au Brésil, RFC au Mexique, PCCC en Corée du Sud)

Certaines destinations exigent un numéro d'identification fiscale du destinataire à des fins douanières. Bigblue récupère ces valeurs à partir des méta-champs de commande Shopify créés par Checkout Blocks sous la section blocs de paiement   espace de noms.

Cet article explique comment les récupérer lors du paiement :

Créez un bloc de paiement par numéro d'identification fiscale (selon le même schéma : champ de texte personnalisé → enregistrer en tant que méta-champ de commande → règles d'affichage). Le guide détaillé ci-dessous utilise le NIF des Îles Canaries ; appliquez ensuite les mêmes étapes pour le CPF, le RFC et le PCCC en utilisant les clés et les règles indiquées dans le tableau et dans la section 6.

Pour plus d'informations sur les expéditions vers les îles Canaries, consultez notre article dédié.

1 - Commencez à créer un nouveau bloc de paiement

• Accédez à Shopify Admin > Blocs de paiement > Blocs, puis cliquez sur Créer un bloc.

• Sélectionnez le type de bloc Champ personnalisé et sélectionnez Modèle vierge.

2 - Complétez les sections Nom du bloc et Contenu.

• Dans la section Nom du bloc, saisissez un nom interne, par exemple NIF.
• Dans la section Contenu, sous Champs, cliquez sur Ajouter un champ personnalisé, sélectionnez Saisie de texte, et dans le modal :
  • Cochez la case Champ obligatoire.
  • Dans le champ « Libellé », saisissez ce que vos acheteurs doivent voir, par exemple « NIF (pour les expéditions vers les îles Canaries) ».

  • Dans Key, entrez es_nif

    ⚠️ Il est essentiel de saisir exactement es_nif pour que Bigblue puisse lire le champ.

  • Dans le message d'erreur client, vous pouvez éventuellement saisir « Un numéro d'identification valide est requis pour les expéditions vers les îles Canaries ».
  • Dans « Expressions régulières », saisie : ^\s*(?:\d{8}[A-Z]|[A-Z]\d{7}[A-Z]|[A-Z]\d{8})\s*$      

• Dans la section Contenu, dans Paramètres, assurez-vous que vos champs de formulaire sont enregistrés en tant que métadonnées de commande.

  ⚠️ Il est essentiel d'enregistrer le champ personnalisé en tant que métadonnée de commande pour que Bigblue puisse le lire.

3 - Complétez la section Règles d'affichage

• Dans la section Règles d'affichage, cliquez sur Ajouter une règle d'affichage, puis dans la fenêtre modale, sélectionnez Province d'expédition.

• Dans la section Règles d'affichage, cliquez sur Sélectionner une province et, dans la fenêtre modale, recherchez Espagne, affichez la liste complète, puis sélectionnez Las Palmas et Santa Cruz de Tenerife.

4 - Vérifiez, enregistrez et publiez

• Assurez-vous que les paramètres sont corrects, veuillez prêter une attention particulière aux éléments suivants :
  • la clé de champ est es_nif,
  • le champ du formulaire est enregistré en tant que métadonnée de commande,
  • les règles d'affichage garantissent que le champ n'apparaît que pour les deux provinces espagnoles correspondant aux îles Canaries.

• Enregistrer toutes les modifications

• Activer le bloc de paiement

5 - Testez la configuration

Nous vous recommandons de tester la configuration (en créant une fausse commande) pour vous assurer qu'elle fonctionne comme prévu :

• Au moment du paiement, testez plusieurs adresses pour vous assurer que le bloc n'apparaît que pour les îles Canaries.
• Au moment du paiement, testez également quelques NIF pour vous assurer que les contraintes de format sont correctes.
• Dans Bigblue, vérifiez la page de commande pour vous assurer que le NIF apparaît dans la partie « Détails du client ».

6 - Même configuration pour le Brésil, le Mexique et la Corée du Sud

Répétez les étapes 1 à 5 pour chaque destination, en modifiant uniquement le nom du bloc, l'intitulé du champ, la clé, l'expression régulière (facultative) ou le message d'erreur, ainsi que les règles d'affichage.

Brésil — CPF (br_cpf  )

• Légende : br_cpf   (exact)
• Règle d'affichage : Pays d'expédition = Brésil
• Expression régulière suggérée : ^\s*\d{3}\.?\d{3}\.?\d{3}-?\d{2}\s*$  
• Étiquette suggérée : par exemple « CPF (obligatoire pour une livraison au Brésil) »

Mexique — RFC (mx_rfc  )

• Légende : mx_rfc   (exact)
• Règle d'affichage : Pays d'expédition = Mexique
• Expression régulière suggérée : ^\s*[A-Za-zÑñ&]{3,4}\d{6}[A-Za-z0-9]{3}\s*$  
• Étiquette suggérée : par exemple « RFC (obligatoire pour une livraison au Mexique) »

Corée du Sud — PCCC (kr_pccc  )

• Légende : kr_pccc   (exact)
• Règle d'affichage : Pays d'expédition = Corée du Sud
• Expression régulière suggérée : ^\s*[Pp][ -]?\d{4}[ -]?\d{4}[ -]?\d{4}\s*$  
• Étiquette suggérée : par exemple, « Code de dédouanement personnel (PCCC) »

Pour chacun de ces blocs également :

• enregistrer le champ du formulaire en tant que méta-champ de commande,
• créer une commande test à destination du pays correspondant,
• Vérifiez que le numéro d'identification fiscale figure bien sur la page de commande de Bigblue.