Export de Commande Fournisseur (JSON)

Vue d'ensemble

Cette documentation décrit le format JSON utilisé pour l'export des commandes fournisseur dans ReassortPro. Le fichier exporté contient toutes les informations nécessaires pour transmettre une commande à un fournisseur.

Structure du fichier JSON

Le fichier JSON exporté contient deux types d'objets principaux :

• SupplierOrderExport : Informations globales de la commande
• SupplierOrderItemExport : Détails de chaque article commandé

SupplierOrderExport

Objet racine représentant la commande fournisseur complète.

Propriétés

Version

• Type : string
• Valeur par défaut : "v1"
• Description : Version du format d'export. Permet de gérer la compatibilité entre différentes versions du format.
• Exemple : "v1"

Code

• Type : string
• Obligatoire : Oui
• Description : Numéro ou code unique identifiant la commande fournisseur dans le système.
• Exemple : "CF-2024-001234"

CustomerCode

• Type : string
• Obligatoire : Oui
• Description : Code client identifiant l'entreprise qui passe la commande auprès du fournisseur.
• Exemple : "CLIENT-FR-456"

CreationDate

• Type : DateTime
• Format : ISO 8601 (yyyy-MM-ddTHH:mm:ss)
• Description : Date et heure de création de la commande.
• Exemple : "2024-01-15T14:30:00"

PurchaserName

• Type : string
• Obligatoire : Oui
• Description : Nom complet de la personne ayant créé ou étant responsable de la commande.
• Exemple : "Marie Dupont"

ContactName

• Type : string
• Obligatoire : Oui
• Description : Nom de la personne à contacter pour toute question concernant cette commande.
• Exemple : "Jean Martin"

DistinctProductCount

• Type : integer
• Description : Nombre de produits distincts dans la commande (nombre de lignes différentes, pas la quantité totale).
• Exemple : 15

Comment

• Type : string
• Optionnel : Oui (peut être null)
• Description : Commentaire global ou instructions particulières concernant la commande.
• Exemple : "Livraison urgente souhaitée avant le 20/01"

ShippingAddress

• Type : PostalAddress
• Description : Adresse de livraison pour la commande. Objet contenant les informations complètes d'adresse postale.
• Exemple :

  {
    "street": "12 Rue du Commerce",
    "postalCode": "75001",
    "city": "Paris",
    "country": "France"
  }
  

Items

• Type : List<SupplierOrderItemExport>
• Description : Liste des articles commandés. Chaque élément représente une ligne de commande.
• Exemple : Voir la section SupplierOrderItemExport ci-dessous

SupplierOrderItemExport

Représente un article individuel dans la commande fournisseur.

Propriétés

CustomerProductCode

• Type : string
• Obligatoire : Oui
• Description : Code produit utilisé par le client (votre référence interne).
• Exemple : "PROD-2024-789"

SupplierCode

• Type : string
• Obligatoire : Oui
• Description : Code produit utilisé par le fournisseur pour identifier l'article dans son catalogue.
• Exemple : "FOURN-ABC-123"

BarCode

• Type : string
• Obligatoire : Oui
• Description : Code-barres du produit (EAN-13, UPC, ou autre format standard).
• Exemple : "3701234567890"

ProductDescription

• Type : string
• Obligatoire : Oui
• Description : Désignation complète du produit pour identification claire.
• Exemple : "Tournevis cruciforme PH2 isolé 1000V"

Quantity

• Type : integer
• Description : Quantité commandée exprimée en unités de vente.
• Exemple : 50

ProductCountByPackaging

• Type : integer
• Valeur par défaut : 1
• Description : Nombre d'unités du produit par conditionnement/emballage. Utile pour les produits vendus par lot ou carton.
• Exemple : 12 (pour un produit vendu par carton de 12)

Comment

• Type : string
• Optionnel : Oui (peut être null)
• Description : Commentaire spécifique à cette ligne de commande.
• Exemple : "Remplacer par référence équivalente si rupture"

Exemple complet

{
    "Version": "v1",
    "Code": "CF-2024-001234",
    "CustomerCode": "CLIENT-FR-456",
    "CreationDate": "2024-01-15T14:30:00",
    "PurchaserName": "Marie Dupont",
    "ContactName": "Jean Martin",
    "DistinctProductCount": 2,
    "Comment": "Livraison urgente souhaitée avant le 20/01",
    "ShippingAddress": {
        "street": "12 Rue du Commerce",
        "postalCode": "75001",
        "city": "Paris",
        "country": "France"
    },
    "Items": [
        {
            "CustomerProductCode": "PROD-2024-789",
            "SupplierCode": "FOURN-ABC-123",
            "BarCode": "3701234567890",
            "ProductDescription": "Tournevis cruciforme PH2 isolé 1000V",
            "Quantity": 50,
            "ProductCountByPackaging": 12,
            "Comment": null
        },
        {
            "CustomerProductCode": "PROD-2024-790",
            "SupplierCode": "FOURN-XYZ-456",
            "BarCode": "3701234567891",
            "ProductDescription": "Pince coupante 160mm isolée",
            "Quantity": 25,
            "ProductCountByPackaging": 1,
            "Comment": "Remplacer par référence équivalente si rupture"
        }
    ]
}

Utilisation

Export d'une commande

1. Accédez à la commande fournisseur que vous souhaitez exporter
2. Cliquez sur le bouton "Exporter en JSON"
3. Le fichier sera téléchargé avec le nom : commande-{Code}.json

Import chez le fournisseur

Le fichier JSON généré peut être :

• Envoyé par email au fournisseur
• Importé directement dans le système du fournisseur s'il supporte ce format
• Utilisé pour intégration EDI (Electronic Data Interchange)

Notes techniques

• Toutes les dates sont au format ISO 8601
• L'encodage du fichier est UTF-8
• Les champs marqués comme optionnels peuvent être null ou absents
• La version actuelle du format est v1
• Pour les questions techniques, contactez l'équipe support ReassortPro