MuleSoft Accelerator for SAP icon

MuleSoft Accelerator for SAP

1.6.x
(6 reviews)

Anypoint Partner Manager EDI setup guide

The following setup guide provides instructions to configure Anypoint Partner Manager (APM) to enable a trading partner to exchange EDI messages. SAP S/4HANA is used as the backend ERP system for creating and managing purchase orders, invoices, shipping notices, and invoice payments.

Configure storage

Configure your storage solution as described here to store transmission content.

Configure host

Configure the host organization as described here. For this use case, setup the following identifiers:

  • EDIFACT - UNB:ZZZ - Mututally Defined
  • Reference ID
  • X12 - GS
  • X12 - ISA with ZZ

    Image of Host Identifiers

Create message types

Creating X12 inbound message types for Purchase Order EDI 850 and Remittance Notice EDI 820

  1. Click New message type and select 'Receive from partner' from the Usage dropdown.
  2. Select 'X12' from Format dropdown to receive X12 EDI messages and version as '4010'.
  3. Select Message type as 850 or 820.
  4. For Schema, select the 'Use standard' option.

    Inbound Message Types X12

Creating X12 outbound message types for PO ACK 855, Shipping Notice 856, and Invoice Notice 810

  1. Click New message type and select 'Send to partner' from the Usage dropdown.
  2. Select 'X12' from Format dropdown to receive X12 EDI Messages and version as '4010'.
  3. Select Message Type as 855, 856, or 810.
  4. For Schema, select the 'Use standard' option.

    Outbound Message Types X12

Creating EDIFACT inbound message types for Purchase Order ORDERS and Remittance Notice EDI REMADV

  1. Click New message type and select 'Receive from partner' from the Usage dropdown.
  2. Select 'EDIFACT' from Format dropdown to receive EDIFACT EDI messages and version as 'd97a'.
  3. Select Message type as ORDERS or REMADV.
  4. For Schema, select the 'Use standard' option.

    Inbound Message Types EDIFACT

Creating EDIFACT outbound message types for PO ORDRSP, Shipping Notice DESADV, and Invoice Notice INVOIC

  1. Click New message type and select 'Send to partner' from the Usage dropdown.
  2. Select 'EDIFACT' from Format drodown to receive X12 EDI Messages and version as 'd97a'.
  3. Select Message Type as ORDRSP, DESADV, or INVOIC.
  4. For Schema, select the 'Use standard' option.

    Outbound Message Types EDIFACT

Creating Source message types to receive outbound message requests from the host's ERP System

  1. Click New message type and select 'Source at the host' from the Usage dropdown.
  2. Select 'Format JSON' to receive outbound message requests in JSON from the SAP Event Listener API.
  3. Upload JSON Schema for PO ACK, Invoice, and Shipping Notice matching the request schema.
  4. Upload the Reference dwl for reading identifiers and business mapping keys.

    Source Message Types

Creating target message types for PO and Remittance Info

  1. Click New message type and select 'Target at host' from the Usage dropdown.
  2. Select 'Format JSON' to receive inbound messages in JSON from Inbound Message flows.
  3. Upload the JSON Schema for Order CIM and Payments CIM format.

    Target Message Types

Create host endpoints

Configuring endpoints for inbound messages

  1. Click New and select 'Target at host' to configure endpoints for the ERP Orders Process API and the Invoice Payments System API.
  2. Use 'HTTPS' as the protocol and configure the host endpoint in the URL.
  3. Select the 'Authentication type' based on host API requirements and appropriate certicate.

    Target Endpoints

Configuring APM endpoints for outbound messages

  1. Click New and select 'Source at host' in the Usage field to receive messages from the SAP S/4HANA Event Listener.
  2. Use 'HTTPS' in the Protocol field and configure the URL, Base Path, and Authentication type as shown in the following:

    Host Endpoints

Configure partner

Configure the trading partner as described here.

For exchanging messages using X12 format, set up the following identifiers:

  • Reference ID
  • X12 - GS
  • X12 - ISA with ZZ

Partner Identifiers MYTHICAL

For exchanging messages using EDIFACT format, set up the following identifiers:

  • Reference ID
  • EDIFACT - UNB:ZZZ - Mutually Defined

Partner Identifiers INGEN

Create partner endpoints

To receive and send EDI messages, set up endpoints based on the mode of exchanging messages such as FTP, AS2, or HTTPS.

Configuring receive endpoints

  1. Click New and select 'Receive from partners' from the Usage dropdown.
  2. Select 'SFTP' in the Protocol dropdown to receive files from a partner's SFTP host.
  3. Add the SFTP host and authentication information.
  4. Create multiple endpoints for picking up different EDI message types.

    Partner SFTP Recieve

Configuring send endpoints

  1. Click New and select 'Send to partners' from the Usage dropdown.
  2. Select 'SFTP' in the Protocol dropdown to send files to a partner's SFTP host.
  3. Add the SFTP host and authentication information.

    Partner SFTP Send

Create APM message flows (For X12)

Create message flows for each EDI message type with source and target endpoints, message types, and mapping scripts to convert to and from X12 EDI Message formats.

Receiving PO 850 from NTO Retail Partner

  1. Select New message flow -> Receive from partner on the 'Message flows' page in APM.
  2. Select NTO Retail or the partner to receive PO from.
  3. Under the Receive section, select the endpoint you created earlier to receive EDI 850 message from SFTP Host.
  4. Select Message type as X12-4010-850.
  5. Under the Map Section, upload the po-nto-x12-4010-850-to-order.dwl file.
  6. Select the Target message type as 'JSON-orderscim' and Endpoint as ERP Orders Process API.

    PO 850 Message Flow

Sending PO ACK 855 to NTO Retail

  1. Select New message flow -> Send to partner on the 'Message flows' page in APM.
  2. Select NTO Retail or the partner to send POC Ack.
  3. Under the Receive section, select the 'APM Send EDI Host' endpoint.
  4. Select Message type as JSON-poack.
  5. Select Reference IDs to route messages to this flow.
  6. Under the Map Section, upload the poack-sap-to-nto-x12-4010-855.dwl file.
  7. Select the Target message type as 'X12-4010-855' and Endpoint as 'SFTP-ntoretail-inbound'.

    PO 855 Message Flow

Sending Shipping Notice 856 to NTO Retail

  1. Select New message flow -> Send to partner on the 'Message flows' page in APM.
  2. Select NTO Retail or the partner to send Shipping Notice.
  3. Under the Receive section, select the 'APM Send EDI Host' endpoint.
  4. Select Message Type as JSON-poack.
  5. Under the Map Section, upload the shipping-sap-to-nto-x12-4010-856.dwl file.
  6. Select Target message type as 'X12-4010-856' and Endpoint as 'SFTP-ntoretail-inbound'.

    PO 856 Message Flow

Sending Invoice 810 to NTO Retail

  1. Select New message flow -> Send to partner on the 'Message flows' page in APM.
  2. Select NTO Retail or the partner to send Invoice.
  3. Under the Receive section, select the 'APM Send EDI Host' endpoint.
  4. Select Message Type as JSON-pack.
  5. Under the Map Section, upload the invoice-sap-to-nto-x12-4010-820.dwl file.
  6. Select Target message type as 'X12-4010-856' and Endpoint as 'SFTP-ntoretail-inbound'.

    PO 810 Message Flow

Receiving Remittance / Payment Info 820 from NTO Retail Partner

  1. Select New message flow -> Receive from partner on the 'Message flows' page in APM.
  2. Select NTO Retail or the partner to receive Payment Info from.
  3. Under the Receive section, select the endpoint you created earlier to receive EDI 820 message from SFTP Host.
  4. Select Message Type as X12-4010-820.
  5. Under the Map Section, upload the po-nto-x12-4010-820-to-payment.dwl file.
  6. Select Target message type as 'JSON-paymentscim' and Endpoint as Invoice Payments System API.

    PO 820 Message Flow

Create APM message flows (For EDIFACT)

Create message flows for each EDI message type with source and target endpoints, message types, and mapping scripts to convert to and from EDIFACT EDI Message formats.

Receiving PO ORDERS from INGEN Systems Partner

  1. Select New message flow -> Receive from partner on the 'Message flows' page in APM.
  2. Select INGEN Systems or the partner to receive PO from.
  3. Under the Receive section, select the endpoint you created earlier to receive EDI ORDERS message from SFTP Host.
  4. Select Message type as EDIFACT-d97a-ORDERS.
  5. Under the Map Section, upload the po-ingen-edifact-d97a-ORDERS-to-order.dwl file.
  6. Select the Target message type as 'JSON-orderscim' and Endpoint as ERP Orders Process API.

    PO ORDERS Message Flow

Sending PO ACK ORDRSP to INGEN Systems

  1. Select New message flow -> Send to partner on the 'Message flows' page in APM.
  2. Select INGEN Systems or the partner to send POC Ack.
  3. Under the Receive section, select the 'APM Send EDI Host' endpoint.
  4. Select Message type as JSON-poack.
  5. Select Reference IDs to route messages to this flow.
  6. Under the Map Section, upload the poack-sap-to-ingen-edifact-d97a-ORDRSP.dwl file.
  7. Select the Target message type as 'EDIFACT-d97a-ORDRSP' and Endpoint as 'SFTP-ingen-inbound'.

    PO ACK ORDRSP Message Flow

Sending Shipping Notice DESADV to INGEN Systems

  1. Select New message flow -> Send to partner on the 'Message flows' page in APM.
  2. Select INGEN Systems or the partner to send Shipping Notice.
  3. Under the Receive section, select the 'APM Send EDI Host' endpoint.
  4. Select Message Type as JSON-poack.
  5. Under the Map Section, upload the shipping-sap-to-ingen-edifact-d97a-DESADV.dwl file.
  6. Select Target message type as 'EDIFACT-d97a-DESADV' and Endpoint as 'SFTP-ingen-inbound'.

    DESADV Message Flow

Sending Invoice INVOIC to INGEN Systems

  1. Select New message flow -> Send to partner on the 'Message flows' page in APM.
  2. Select INGEN Systems or the partner to send Invoice.
  3. Under the Receive section, select the 'APM Send EDI Host' endpoint.
  4. Select Message Type as JSON-pack.
  5. Under the Map Section, upload the invoice-sap-to-ingen-edifact-d97a-INVOIC.dwl file.
  6. Select Target message type as 'EDIFACT-d97a-INVOIC' and Endpoint as 'SFTP-ingen-inbound'.

    INVOIC Message Flow

Receiving Remittance / Payment Info REMADV from INGEN Systems Partner

  1. Select New message flow -> Receive from partner on the 'Message flows' page in APM.
  2. Select INGEN Systems or the partner to receive Payment Info from.
  3. Under the Receive section, select the endpoint you created earlier to receive EDIFACT REMADV from SFTP Host.
  4. Select Message Type as EDIFACT-d97a-REMADV.
  5. Under the Map Section, upload the remittance-ingen-edifact-d97a-REMADV-to-payment.dwl file.
  6. Select Target message type as 'JSON-paymentscim' and Endpoint as Invoice Payments System API.

    REMADV Message Flow

After you complete the message flows configuration, deploy the message flows.

You can also visit the troubleshooting steps if your Partner Manager is not working as expected.

Reviews