ÍNDICE

  1. Visión general
  2. Ejemplo de utilización
  3. Pantalla Adapter EAI
  4. Pantalla Configuración del Adapter MATA410
  5. Tags
  6. Tablas utilizadas

 

01. VISIÓN GENERAL

Configuración del Adapter order con formatos diferentes (XML,JSON). 

02. EJEMPLO DE UTILIZACIÓN

Cuando se utiliza el Adapter order (MATA120MATA410) ambos, obligatoriamente, deben tener la misma configuración del formato de archivo (XML,JSON). 

Se recomienda la utilización de la versión más actual (4.003).

03. PANTALLA ADAPTER EAI                  

         Módulo SIGACFG (Configurador) Entorno > Schedule > Adapter EAI

      

04. PANTALLA CONFIGURACIÓN DEL ADAPTER MATA410

         Ejemplo de configuración del mensaje ORDER.

       


         Campo Formato configurado para XML.

       


         Campo Formato configurado para JSON.

       

05. TAGS

    Elemento

    Descripción

    Observación

    BusinessContent

    CompanyId

    Empresa

    El campo se completa con el valor de referencia De/A Empresa.

    CompanyInternalId

    InternalId de la empresa

    El campo se completa con el valor de referencia De/A Empresa y Sucursal.

    BranchId

    Sucursal

    El campo se completa con el valor de referencia De/A Sucursal.

    OrderPurpose

    Objetivo del pedido

    Indica si el pedido se trata de:
    1 - Compra

    2 - Venta

    InternalId

    InternalId del pedido

    El campo se completa con el valor de referencia De/A Pedidos (SC5/SC7).

    RegisterDate

    Fecha de emisión


    OrderId

    Número del pedido

    Código referente al registro Protheus (C5_NUM).

    CustomerCode

    Código del Cli/Prov

    Código referente al registro Protheus (A1_COD+A1_LOJA/A2_COD+A2_LOJA).

    Para la utilización de este, el CustomerInternalId no debe enviarse.

    CustomerInternalId

    InternalId del Cli/Prov

    Código referente a De/A (XXF).

    Para su utilización debe tener el Adapter CUSTOMERVENDOR (MATA030 o MATA360) registrado.

    PaymentTermCode

    Condición de pago

    Código referente al registro Protheus (E4_CODIGO).

    PaymentConditionInternalId

    InternalId de la condición

    de pago

    Código con valor de referencia De/A Condición de pago (SE4).

    Para su utilización debe tener el Adapter PAYMENTCONDITION (MATA360) registrado.

    Discount

    Descuento

    Realiza el cálculo con base en el valor total de cada ítem y agrega en el campo C5_DESC1 (valor de descuento en el encabezado). Para otras versiones, el tratamiento de esta TAG se modifica, agregando el descuento en el encabezado (SC5), por ejemplo.

    PriceTableNumber

    Lista de precios

    Código con valor de referencia De/A Lista de precios (DA0).

    Para su utilización debe tener el Adapter PRICELISTHEADERITEM (OMSA010) registrado o registrar manualmente el valor de referencia.

    SalesOrderItens.Item

    InternalId

    InternalID Ítem del pedido

    El campo se completa con el valor de referencia De/A Ítems del pedido (C6_ITEM).

    OrderItem

    Ítem del pedido

    El campo se completa con el valor secuencial de referencia De/A Ítems del pedido (C6_ITEM).

    ItemInternalId

    InternalId del producto

    El campo se completa con el valor de referencia De/A Producto (B1_COD).

    Para su utilización debe tener el Adapter ÍTEM (MATA010) registrado.

    ItemCode

    Código del producto

    Código referente al registro Protheus (B1_COD).

    Quantity

    Cantidad


    UnityPrice

    Precio unitario


    TotalPrice

    Valor total


    TypeOperation

    Tipo de operación

    Si es menor que 3 se tratará como C6_OPER, de lo contrario, se tratará como C6_TES.

    CostCenterCode

    Centro de costo

    Código referente al registro Protheus (CTT_CUSTO).

    CostCenterInternalId

    InternalID del Centro de costo

    El campo se completa con el valor de referencia De/A Centro de costo (CTT_CUSTO).

    Para su utilización debe tener el Adapter COSTCENTER (CTBA030) registrado.

    Elemento

    Descripción

    Observación

    BusinessContent

    CompanyId

    Empresa

    El campo se completa con el valor de referencia De/A Empresa.

    CompanyInternalId

    InternalId de la empresa

    El campo se completa con el valor de referencia De/A Empresa y Sucursal.

    BranchId

    Sucursal

    El campo se completa con el valor de referencia De/A Sucursal.

    OrderPurpose

    Objetivo del pedido

    Indica si el pedido se trata de:
    1 - Compra

    2 - Venta

    InternalId

    InternalId del pedido

    El campo se completa con el valor de referencia De/A Pedidos (SC5/SC7).

    RegisterDate

    Fecha de emisión


    OrderId

    Número del pedido

    Código referente al registro Protheus (C5_NUM).

    CustomerCode

    Código del Cli/Prov

    Código referente al registro Protheus (A1_COD+A1_LOJA/A2_COD+A2_LOJA).

    Para la utilización de este, el CustomerInternalId no debe enviarse.

    CustomerInternalId

    InternalId del Cli/Prov

    Código referente a De/A (XXF).

    Para su utilización debe tener el Adapter CUSTOMERVENDOR (MATA030 o MATA360) registrado.

    PaymentTermCode

    Condición de pago

    Código referente al registro Protheus (E4_CODIGO).

    PaymentConditionInternalId

    InternalId de la condición

    de pago

    Código con valor de referencia De/A Condición de pago (SE4).

    Para su utilización debe tener el Adapter PAYMENTCONDITION (MATA360) registrado.

    Discount

    Descuento

    Realiza el cálculo con base en el valor total de cada ítem y agrega en el campo C6_VALDESC (valor de descuento para cada ítem). Para otras versiones, el tratamiento de esta TAG se modifica, agregando el descuento en el encabezado (SC5), por ejemplo.

    SalesOrderItens.Item

    InternalId

    InternalID Ítem del pedido

    El campo se completa con el valor de referencia De/A Ítems del pedido (C6_ITEM).

    OrderItem

    Ítem del pedido

    El campo se completa con el valor secuencial de referencia De/A Ítems del pedido (C6_ITEM).

    ItemInternalId

    InternalId del producto

    El campo se completa con el valor de referencia De/A Producto (B1_COD).

    Para su utilización debe tener el Adapter ÍTEM (MATA010) registrado.

    ItemCode

    Código del producto

    Código referente al registro Protheus (B1_COD).

    Quantity

    Cantidad


    UnityPrice

    Precio unitario


    TotalPrice

    Valor total


    TypeOperation

    Tipo de operación

    Si es menor que 3 se tratará como C6_OPER, de lo contrario, se tratará como C6_TES.

    CostCenterCode

    Centro de costo

    Código referente al registro Protheus (CTT_CUSTO).

    CostCenterInternalId

    InternalID del Centro de costo

    El campo se completa con el valor de referencia De/A Centro de costo (CTT_CUSTO).

    Para su utilización debe tener el Adapter COSTCENTER (CTBA030) registrado.



    Elemento

    Descripción

    Observación

    BusinessContent

    CompanyId

    Empresa

    El campo se completa con el valor de referencia De/A Empresa.

    CompanyInternalId

    InternalId de la empresa

    El campo se completa con el valor de referencia De/A Empresa y Sucursal.

    BranchId

    Sucursal

    El campo se completa con el valor de referencia De/A Sucursal.

    OrderPurpose

    Objetivo del pedido

    Indica si el pedido se trata de:
    1 - Compra

    2 - Venta

    InternalId

    InternalId del pedido

    El campo se completa con el valor de referencia De/A Pedidos (SC5/SC7).

    RegisterDate

    Fecha de emisión


    OrderId

    Número del pedido

    Código referente al registro Protheus (C5_NUM).

    CustomerCode

    Código del Cli/Prov

    Código referente al registro Protheus (A1_COD+A1_LOJA/A2_COD+A2_LOJA).

    Para la utilización de este, el CustomerInternalId no debe enviarse.

    CustomerInternalId

    InternalId del Cli/Prov

    Código referente a De/A (XXF).

    Para su utilización debe tener el Adapter CUSTOMERVENDOR (MATA030 o MATA360) registrado.

    PaymentTermCode

    Condición de pago

    Código referente al registro Protheus (E4_CODIGO).

    PaymentConditionInternalId

    InternalId de la condición

    de pago

    Código con valor de referencia De/A Condición de pago (SE4).

    Para su utilización debe tener el Adapter PAYMENTCONDITION (MATA360) registrado.

    Discount

    Descuento

    Realiza el cálculo con base en el valor total de cada ítem y agrega en el campo C6_VALDESC (valor de descuento para cada ítem). Para otras versiones, el tratamiento de esta TAG se modifica, agregando el descuento en el encabezado (SC5), por ejemplo.

    PriceTableNumber

    Lista de precios

    Código con valor de referencia De/A Lista de precios (DA0).

    Para su utilización debe tener el Adapter PRICELISTHEADERITEM (OMSA010) registrado o registrar manualmente el valor de referencia.

    SalesOrderItens.Item

    InternalId

    InternalID Ítem del pedido

    El campo se completa con el valor de referencia De/A Ítems del pedido (C6_ITEM).

    OrderItem

    Ítem del pedido

    El campo se completa con el valor secuencial de referencia De/A Ítems del pedido (C6_ITEM).

    ItemInternalId

    InternalId del producto

    El campo se completa con el valor de referencia De/A Producto (B1_COD).

    Para su utilización debe tener el Adapter ÍTEM (MATA010) registrado.

    ItemCode

    Código del producto

    Código referente al registro Protheus (B1_COD).

    Quantity

    Cantidad


    UnityPrice

    Precio unitario


    TotalPrice

    Valor total


    TypeOperation

    Tipo de operación

    Si es menor que 3 se tratará como C6_OPER, de lo contrario, se tratará como C6_TES.

    CostCenterCode

    Centro de costo

    Código referente al registro Protheus (CTT_CUSTO).

    CostCenterInternalId

    InternalID del Centro de costo

    El campo se completa con el valor de referencia De/A Centro de costo (CTT_CUSTO).

    Para su utilización debe tener el Adapter COSTCENTER (CTBA030) registrado.



    Elemento

    Descripción

    Observación

    BusinessContent

    CompanyId

    Empresa

    El campo se completa con el valor de referencia De/A Empresa.

    CompanyInternalId

    InternalId de la empresa

    El campo se completa con el valor de referencia De/A Empresa y Sucursal.

    BranchId

    Sucursal

    El campo se completa con el valor de referencia De/A Sucursal.

    OrderPurpose

    Objetivo del pedido

    Indica si el pedido se trata de:
    1 - Compra

    2 - Venta

    InternalId

    InternalId del pedido

    El campo se completa con el valor de referencia De/A Pedidos (SC5/SC7).

    RegisterDate

    Fecha de emisión


    OrderId

    Número del pedido

    Código referente al registro Protheus (C5_NUM).

    CustomerCode

    Código del Cli/Prov

    Código referente al registro Protheus (A1_COD+A1_LOJA/A2_COD+A2_LOJA).

    Para la utilización de este, el CustomerInternalId no debe enviarse.

    CustomerInternalId

    InternalId del Cli/Prov

    Código referente a De/A (XXF).

    Para su utilización debe tener el Adapter CUSTOMERVENDOR (MATA030 o MATA360) registrado.

    PaymentTermCode

    Condición de pago

    Código referente al registro Protheus (E4_CODIGO).

    PaymentConditionInternalId

    InternalId de la condición

    de pago

    Código con valor de referencia De/A Condición de pago (SE4).

    Para su utilización debe tener el Adapter PAYMENTCONDITION (MATA360) registrado.

    FreightType

    Tipo de Flete

    Código referente al registro Protheus (C5_TPFRETE).

    Carrier Code

    Empresa de transporte

    Código con valor de referencia De/A Empresa de transportes (SA4).

    Para su utilización debe tener el Adapter CARRIERS (MATA050) registrado

    Invoice Message

    Mensaje de la factura

    Código referente al registro Protheus (C5_MENNOTA).

    FreightValue

    Valor del flete

    Código referente al registro Protheus (C5_FRETE).

    GrossWeight

    Peso bruto

    Código referente al registro Protheus (C5_PBRUTO).

    InsuranceValue

    Valor del seguro

    Código referente al registro Protheus (C5_SEGURO).

    SellerCode

    Código del vendedor

    Código con valor de referencia De/A Vendedores (SE3).

    Para su utilización debe tener el Adapter SELLER (MATA040) registrado o registrar manualmente el valor de referencia.

    SellerIdCode

    Código del vendedor

    Código referente al registro Protheus (A3_COD)

    Para la utilización de este, el SellerCode no debe enviarse.

    PriceTableNumber

    Lista de precios

    Código con valor de referencia De/A Lista de precios (DA0).

    Para su utilización debe tener el Adapter PRICELISTHEADERITEM (OMSA010) registrado.

    PriceTableIdCode

    Lista de precios

    Código referente al registro Protheus (DA0_CODTAB)

    Para la utilización de este, el PriceTableNumber no debe enviarse.

    InvoiceNumber

    Número de la factura

    Código referente al registro Protheus (C5_NOTA).

    InvoiceSerie

    Serie de la factura

    Código referente al registro Protheus (C5_SERIE).

    CurrencyId

    Moneda

    Código con valor de referencia De/A Moneda (CTO).

    Para su utilización debe tener el Adapter CURRENCY (CTBA140) registrado.

    SalesOrderItens.Item

    InternalId

    InternalID Ítem del pedido

    El campo se completa con el valor de referencia De/A Ítems del pedido (C6_ITEM).

    OrderItem

    Ítem del pedido

    El campo se completa con el valor secuencial de referencia De/A Ítems del pedido (C6_ITEM).

    ItemInternalId

    InternalId del producto

    El campo se completa con el valor de referencia De/A Producto (B1_COD).

    Para su utilización debe tener el Adapter ÍTEM (MATA010) registrado.

    ItemCode

    Código del producto

    Código referente al registro Protheus (B1_COD).

    ItemDescription

    Descripción del ítem

    Código referente al registro Protheus (C6_PRODUTO).

    WarehouseInternalId

    Lugares de stock

    El campo se completa con el valor de referencia De/A Almacén (NRR).

    Para su utilización debe tener el Adapter WAREHOUSE (AGRA045) registrado.

    UnitOfMeasureInternalId

    Unidad de medida del ítem

    El campo se completa con el valor de referencia De/A Unidad de medida (SAH).

    Para su utilización debe tener el Adapter UNITOFMEASURE (QIEA030) registrado.

    Quantity

    Cantidad

    Código referente al registro Protheus (C6_QTDVEN).

    UnityPrice

    Precio unitario

    Código referente al registro Protheus (C6_PRCVEN).

    TotalPrice

    Valor total

    Código referente al registro Protheus (C6_PRUNIT).

    TypeOperation

    Tipo de operación

    Si es menor que 3 se tratará como C6_OPER, de lo contrario, se tratará como C6_TES.

    CostCenterCode

    Centro de costo

    Código referente al registro Protheus (CTT_CUSTO).

    CostCenterInternalId

    InternalID del Centro de costo

    El campo se completa con el valor de referencia De/A Centro de costo (CTT_CUSTO).

    Para su utilización debe tener el Adapter COSTCENTER (CTBA030) registrado.

    ItemDiscounts

    Valor de descuento del ítem

    Realiza el cálculo con base en el valor total de cada ítem y agrega en el campo C6_VALDESC (valor de descuento para cada ítem). Para otras versiones, el tratamiento de esta TAG se modifica, agregando el descuento en el encabezado (SC5), por ejemplo.

    LotNumber

    Lote del ítem

    Código referente al registro Protheus (C6_LOTECTL).

    SubLotNumber

    Sublote del ítem

    Código referente al registro Protheus (C6_NUMLOTE).

    SeriesItem

    Serie del ítem 

    Código referente al registro Protheus (C6_NUMSERI).

    AddressingItem

    Dirección del ítem

    Código referente al registro Protheus (C6_LOCALIZ).

    InvoicingDate

    Fecha de facturación

    C6_DTFAT).

    DeliveryDate

    Fecha de entrega

    C6_ENTREG).

    AllocatedQuantity

    Cantidad asignada

    C6_QTDEMP).

    QuantityDelivered

    Cantidad entregada

    C6_QTDENT).

    ItemReserveInternalId

    Reserva del ítem

    El campo se completa con el valor de referencia De/A Reserva del ítem (C0_DOCRES).

    Para su utilización debe tener el Adapter ITEMRESERVE (LOJA704) registrado.

    CustomerOrderNumber

    Número de pedido del cliente

    Código referente al registro Protheus (C6_PEDCLI).

    ListOfApportionOrderItem

    ProjectInternalId

    Código del proyecto

    El campo se completa con el valor de referencia De/A Proyecto (AF8_PROJET).

    Para su utilización debe tener el Adapter PROJECT  (PMSA200) registrado.

    TaskInternalId

    Código de la tarea

    El campo se completa con el valor de referencia De/A Código de la tarea (AF9_TAREFA).

    Para su utilización debe tener el Adapter TASKPROJECT (PMSA203) registrado.



    06. TABLAS UTILIZADAS

    • XX4 - Adapters EAI

    • SC5 - Pedidos de venta
    • SC6 - Ítems de los pedidos de venta