Importar ASNs de entrada através de entidades de dados

Artigo
06/07/2024

Os avisos de envio antecipado (ASNs) notificam-no sobre entregas de fornecedores. Ajudam o remetente a descrever o conteúdo de um envio e informações adicionais sobre o mesmo, como os itens e a embalagem.

Os avisos ASN podem ajudar os trabalhadores do armazém a ficarem informados sobre o que vai chegar e quando. Portanto, podem preparar-se. Além disso, os trabalhadores do armazém podem usar ASNs para fazer corresponder os detalhes de um envio à nota de encomenda ou ordem de envio de entrada relacionada que foi previamente criada.

Este artigo apresenta uma coleção de cenários que mostram, através de exemplos, como trabalhar ficheiros ASN.

Importante

ASN de entrada a importação aplica-se apenas a itens habilitados para processos de gestão de armazéns (WMS). Antes de receber um ASN, uma nota de encomenda ou uma ordem de envio de entrada deve ser registada no sistema.

ASN de entrada

Importa ASNs de entrada usando as entidades de dados compostos ASN de entrada V3 e/ou ASN de entrada V5, que levam vantagem das seguintes entidades subordinadas:

Cabeçalho de carga de entrada
Cabeçalho de envio de entrada
Estruturas de embalagem de carga de entrada
Casos de estrutura de embalagem da carga de entrada
Linhas de caixa de estrutura de embalagem de carga de entrada
Linhas de estrutura de embalagem de carga de entrada

As entidades de dados combinados ASN de entrada destinam-se a cenários de integração assíncronos onde, por exemplo, podem ser utilizadas importações baseadas em ficheiros XML.

Nota

Somente a entidade de dados ASN de entrada V5 suporta ordens de envio de entrada. O tipo de ordem deve ser especificado como parte dos dados ASN, que pode ser InboundShipmentOrder para ordens de envio de entrada ou Purch para notas de encomenda.

Formato XML para importação de ASNs V3

O Supply Chain Management oferece suporte ao seguinte formato XML para importação de ASNs. Cada nó no ficheiro XML representa um atributo de uma entidade individual.

<?xml version="1.0" encoding="utf-8"?>
<Document>
    <WHSInboundLoadHeaderEntity>
        <WHSInboundShipmentHeaderEntity>
            <WHSInboundLoadPackingStructureEntity>
                <WHSInboundLoadPackingStructureCaseEntity>
                    <WHSInboundPackingStructureCaseLineV3Entity>
                    </WHSInboundPackingStructureCaseLineV3Entity>
                </WHSInboundLoadPackingStructureCaseEntity>
                <WHSInboundLoadPackingStructureLineV3Entity>
                </WHSInboundLoadPackingStructureLineV3Entity>
            </WHSInboundLoadPackingStructureEntity>
        </WHSInboundShipmentHeaderEntity>
    </WHSInboundLoadHeaderEntity>
</Document>

Exemplos de uso da entidade ASN de entrada V3 (apenas para notas de encomenda)

As subseções a seguir fornecem exemplos de ficheiros de importação XML ASN para envios de fornecedores de notas de encomenda para ASN de entrada V3.

Exemplo 1

O exemplo a seguir mostra um ficheiro XML para importar envios de fornecedores relativos a uma nota de encomenda quando não estão incluídos detalhes do caso.

<?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>

Exemplo 2

O exemplo a seguir mostra um ficheiro XML para importar envios de fornecedores relativos a uma nota de encomenda quando estão incluídos detalhes do caso.

<?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>

Exemplo 3

O exemplo a seguir mostra um ficheiro XML para importar envios de fornecedores relativos a múltiplas notas de encomenda quando estão incluídos detalhes do caso.

<?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>

Exemplo de uso da entidade ASN de entrada V5

Esta secção fornece um exemplo de ficheiro de importação XML de ASN para ordens de envio de entrada que podem ser utilizados com a entidade ASN de entrada V5.

Nota

A entidade ASN de entrada V5 suporta o MODULE atributo para o elemento WHSInboundLoadPackingStructureEntity e para o elemento WHSInboundLoadPackingStructureLineV5Entity. Este atributo pode ser utilizado para notas de encomenda (MODULE="Purch") e ordens de envio de entrada (MODULE="InboundShipmentOrder").

O exemplo a seguir mostra um ficheiro XML para importar envios para uma ordem de envio de entrada que não inclui detalhes do caso.

<?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>

Inspecione os resultados da importação de um ficheiro ASN

Siga estes passos para inspecionar os resultados da importação de um ficheiro ASN.

Aceda a Warehouse management > Cargas > Todas as cargas.
Encontre e abra uma carga que foi criada como parte de uma importação de ASN.
No Separador Rápido Carga, deverá ver valores baseados no ficheiro XML.
No Separador Rápido Linhas de carga, deverá ver os números de notas de encomenda e os detalhes do item que se baseiam no ficheiro XML.
No Painel de Ações, no separador Enviar e receber, no grupo Receber, selecione Estrutura de embalagem para rever a estrutura de embalagem da carga.
No Separador Rápido Paletes, deverá ver as placas de identificação baseadas no ficheiro XML.
No Separador Rápido Casos, deverá ver casos baseados no ficheiro XML.
No Separador Rápido Itens, deverá ver itens e quantidades baseados no ficheiro XML.

Partilhar via