Importer les APE entrants via des entités de données
Les avis préalables d’expédition (ASN) vous informent des livraisons des fournisseurs. Ils aident l’expéditeur à décrire le contenu d’un envoi et à donner des informations supplémentaires à son sujet, concernant par exemple les articles et l’emballage.
Les ASN peuvent aider les employés d’entrepôt à savoir ce qui arrive et quand. Ils peuvent se préparer en conséquence. De plus, les magasiniers peuvent utiliser les ASN pour faire correspondre les détails d’une expédition à la commande client ou à l’ordre d’expédition entrant associé(e) qui a été créé(e) précédemment.
Cet article présente une collection de scénarios qui montrent, à travers des exemples, comment utiliser les fichiers ASN.
Important
L’importation des ASN entrants ne s’applique qu’aux articles activés pour les processus de gestion des entrepôts (WMS). Avant de pouvoir recevoir un APE, une commande fournisseur ou un ordre d’expédition entrant doit être enregistré(e) dans le système.
APE entrant
Vous importez des APE entrants en utilisant les entités de données composites ASN V3 entrant et/ou ASN V5 entrant qui tirent parti des entités enfants suivantes :
- En-tête de la charge entrante
- En-tête d’expédition entrante
- Structures de conditionnement de la charge entrante
- Cas de structure de conditionnement de la charge entrante
- Lignes de cas de structure de conditionnement de la charge entrante
- Lignes de structure de conditionnement de la charge entrante
Les entités de données composites ASN entrant sont destinées à des scénarios d’intégration asynchrones dans lesquels, par exemple, des importations basées sur des fichiers XML peuvent être utilisées.
Remarque
Seule l’entité de données ASN V5 entrant prend en charge les ordres d’expédition entrants. Le type de commande doit être spécifié dans les données APE, qui peuvent être soit InboundShipmentOrder pour les ordres d’expédition entrants, soit Purch pour les commandes fournisseur.
Format XML pour l’importation des ASN V3
Supply Chain Management prend en charge le format XML suivant pour l’importation des APE. Chaque nœud du fichier XML représente un attribut d’une entité individuelle.
<?xml version="1.0" encoding="utf-8"?>
<Document>
<WHSInboundLoadHeaderEntity>
<WHSInboundShipmentHeaderEntity>
<WHSInboundLoadPackingStructureEntity>
<WHSInboundLoadPackingStructureCaseEntity>
<WHSInboundPackingStructureCaseLineV3Entity>
</WHSInboundPackingStructureCaseLineV3Entity>
</WHSInboundLoadPackingStructureCaseEntity>
<WHSInboundLoadPackingStructureLineV3Entity>
</WHSInboundLoadPackingStructureLineV3Entity>
</WHSInboundLoadPackingStructureEntity>
</WHSInboundShipmentHeaderEntity>
</WHSInboundLoadHeaderEntity>
</Document>
Exemples d’utilisation de l’entité Inbound ASN V3 entrant (uniquement pour les commandes fournisseur)
Les sous-sections suivantes fournissent des exemples de fichiers XML d’importation d’APE pour les expéditions de fournisseurs de commandes fournisseur, pour les entités ASN V3 entrant.
Exemple 1
L’exemple suivant montre un fichier XML pour l’importation d’expéditions de fournisseurs pour une commande client lorsqu’aucun détail d’incident n’est inclus.
<?xml version="1.0" encoding="utf-8"?>
<Document>
<WHSInboundLoadHeaderEntity TRACTORNUMBER="0000101">
<WHSInboundShipmentHeaderEntity VENDORSHIPMENTID="VendASN_01" VENDORADDRESSCOUNTRYREGIONID = "USA" VENDORADDRESSSTREET = "123 Coffee Street" VENDORADDRESSSTATEID = "WA" VENDORADDRESSCITY = "Redmond" VENDORADDRESSZIPCODE = "98052">
<WHSInboundLoadPackingStructureEntity LICENSEPLATENUMBER="LP_ASN_001">
<WHSInboundLoadPackingStructureLineV3Entity PURCHASEORDERNUMBER="00000176" ITEMNUMBER="A0001" QUANTITY="1" UNITSYMBOL="pcs" />
</WHSInboundLoadPackingStructureEntity>
</WHSInboundShipmentHeaderEntity>
</WHSInboundLoadHeaderEntity>
</Document>
Exemple 2
L’exemple suivant montre un fichier XML pour l’importation d’expéditions de fournisseurs pour une commande client lorsque des détails d’incident sont inclus.
<?xml version="1.0" encoding="utf-8"?>
<Document>
<WHSInboundLoadHeaderEntity ESTIMATEDARRIVALDATETIME="2021-04-25T11:00:00+00:00">
<WHSInboundShipmentHeaderEntity VENDORSHIPMENTID="MVR_SNN_0004">
<WHSInboundLoadPackingStructureEntity LICENSEPLATENUMBER="MVR_SNN_0004" PACKEDTOTALQUANTITY="2.00">
<WHSInboundLoadPackingStructureCaseEntity PARENTPACKINGSTRUCTURELICENSEPLATENUMBER="MVR_SNN_0004" LICENSEPLATENUMBER="MVR_SNN_0004A" PACKEDTOTALQUANTITY="2.00" />
<WHSInboundLoadPackingStructureLineV3Entity PURCHASEORDERNUMBER="00000175" ITEMNUMBER="A0001" PURCHASEORDERLINENUMBER="1" QUANTITY="2.00" UNITSYMBOL="pcs" />
</WHSInboundLoadPackingStructureEntity>
</WHSInboundShipmentHeaderEntity>
</WHSInboundLoadHeaderEntity>
</Document>
Exemple 3
L’exemple suivant montre un fichier XML pour l’importation d’expéditions de fournisseurs pour plusieurs commandes client lorsque des détails d’incident sont inclus.
<?xml version="1.0" encoding="utf-8"?>
<Document>
<WHSInboundLoadHeaderEntity TRACTORNUMBER="0000101">
<WHSInboundShipmentHeaderEntity VENDORSHIPMENTID="VendASN_01" VENDORADDRESSCOUNTRYREGIONID = "USA" VendorAddressStreet = "123 Coffee Street" VENDORADDRESSSTATEID = "WA" VENDORADDRESSCITY = "Redmond" VENDORADDRESSZIPCODE = "98052">
<WHSInboundLoadPackingStructureEntity LICENSEPLATENUMBER="LP_ASN_001">
<WHSInboundLoadPackingStructureLineV3Entity PURCHASEORDERNUMBER="00000176" ITEMNUMBER="A0001" QUANTITY="100" UNITSYMBOL="pcs" />
</WHSInboundLoadPackingStructureEntity>
</WHSInboundShipmentHeaderEntity>
<WHSInboundShipmentHeaderEntity VENDORSHIPMENTID="VendASN_02" VENDORADDRESSCOUNTRYREGIONID = "USA" VendorAddressStreet = "123 Coffee Street" VENDORADDRESSSTATEID = "WA" VENDORADDRESSCITY = "Redmond" VENDORADDRESSZIPCODE = "98052">
<WHSInboundLoadPackingStructureEntity LICENSEPLATENUMBER="LP_ASN_001">
<WHSInboundLoadPackingStructureLineV3Entity PURCHASEORDERNUMBER="00000177" ITEMNUMBER="A0001" QUANTITY="200" UNITSYMBOL="pcs" />
<WHSInboundLoadPackingStructureLineV3Entity PURCHASEORDERNUMBER="00000177" ITEMNUMBER="P0004" QUANTITY="300" UNITSYMBOL="pcs" ITEMBATCHNUMBER="BN0001" />
</WHSInboundLoadPackingStructureEntity>
<WHSInboundLoadPackingStructureEntity LICENSEPLATENUMBER="LP_ASN_002">
<WHSInboundLoadPackingStructureCaseEntity LICENSEPLATENUMBER="LP_ASN_002_C01">
<WHSInboundLoadPackingStructureCaseLineV3Entity PURCHASEORDERNUMBER="00000177" ITEMNUMBER="A0001" QUANTITY="400" UNITSYMBOL="pcs" />
</WHSInboundLoadPackingStructureCaseEntity>
</WHSInboundLoadPackingStructureEntity>
</WHSInboundShipmentHeaderEntity>
</WHSInboundLoadHeaderEntity>
</Document>
Exemple d’utilisation de l’entité ASN V5 entrant
Cette section fournit un exemple de fichier d’importation APE XML pour les ordres d’expédition entrants qui peut être utilisé avec l’entité ASN V5 entrant.
Remarque
L’entité ASN V5 entrant prend en charge l’attribut MODULE
pour les deux éléments WHSInboundLoadPackingStructureEntity
et l’élément WHSInboundLoadPackingStructureLineV5Entity
. Cet attribut peut être utilisé à la fois pour les commandes fournisseur (MODULE="Purch"
) et les ordres d’expédition entrants (MODULE="InboundShipmentOrder"
).
L’exemple suivant présente un fichier XML pour l’importation d’expéditions pour un ordre d’expédition entrant qui n’inclut pas les détails de l’instance.
<?xml version="1.0" encoding="utf-8"?>
<Document>
<WHSInboundLoadHeaderEntity TRACTORNUMBER="0000104">
<WHSInboundShipmentHeaderEntity VENDORSHIPMENTID="VendASN_04">
<WHSInboundLoadPackingStructureEntity MODULE="InboundShipmentOrder" LICENSEPLATENUMBER="LP_ASN_004">
<WHSInboundLoadPackingStructureLineV5Entity MODULE="InboundShipmentOrder" ORDERNUMBER="IO04" ORDERLINENUMBER="1" ITEMNUMBER="A0001" QUANTITY="2" UNITSYMBOL="pcs"/>
</WHSInboundLoadPackingStructureEntity>
</WHSInboundShipmentHeaderEntity>
</WHSInboundLoadHeaderEntity>
</Document>
Inspecter les résultats de l’importation d’un fichier ASN
Procédez comme suit pour inspecter les résultats de l’importation d’un fichier ASN.
- Accédez à Gestion des entrepôts > Chargements > Tous les chargements.
- Recherchez et ouvrez un chargement qui a été créé dans le cadre d’une importation d’ASN.
- Dans le raccourci Chargement, vous devez voir les valeurs basées sur le fichier XML.
- Dans le raccourci Lignes de chargement, vous devez voir les numéros de commande client et les détails des articles basés sur le fichier XML.
- Dans le volet Actions, dans l’onglet Expédier et recevoir, dans le groupe Recevoir, sélectionnez Structure de conditionnement pour examiner la structure de conditionnement du chargement.
- Dans le raccourci Palettes, vous devez voir les contenants basés sur le fichier XML.
- Dans le raccourci Incidents, vous devez voir les incidents basés sur le fichier XML.
- Dans le raccourci Articles, vous devez voir les articles et quantités basés sur le fichier XML.