Created on 2021-01-26 15:05:07; Last updated on 2022-01-18 02:00:24
This "How to" should provide you with the necessary steps to implement a working integration with Rockfarm from scratch using Babelway. Rockfarm is a partner of MercuryGate and integrating with Rockfarm involves integrating with MercuryGate systems.
Preferred Protocols and Message Formats. When integrating with Rockfarm, you will be expected to send X12 (version 4010) messages through FTP.
Setting up your connection
Rockfarm uses FTP. Your channel will look something like this:
For FTP, create an "FTP Client" gateway IN as follows. Note that Rockfarm needs to share with you the information required to complete the highlighted section.
In order to send content to Rockfarm, you will need to complete the matching FTP client outgoing gateway:
Once again, you will need Rockfarm to share the highlighted information with you. Most likely, only the directory will differ between the two gateways and you will use the same credentials to log in to their FTP server.
Whether you begin with the incoming or outgoing flow, you can test your connection by creating a dummy channel using your newly created gateway, "Not defined" message definitions and a "no transform" transformation to just ensure that you can exchange content with Rockfarm correctly. Next, you will want to validate that you can correctly convert your format to theirs in a way that matches their requirements.
Configuring your messages
You can find all the samples for their messages in the resources bundle.
Rockfarm will send back 997 functional acknowledgements for each motor carrier freight details and invoice (210) you send out. If you wish to correlate incoming acknowledgements with the 210 messages you issue, you can have a look at Babelway's 997 implementation.