Back to Integrations

EDI Integration

Exchange demurrage invoices electronically with trading partners using EDI X12.

Supported Transaction Sets

CodeNameDirectionPurpose
210Motor Carrier Freight Details and InvoiceOutboundSend demurrage invoice
214Transportation Carrier Shipment StatusOutboundStatus updates
990Response to Load TenderInboundAccept/reject
997Functional AcknowledgmentBothConfirm receipt

Communication Methods

AS2

Applicability Statement 2

Encryption + Signatures

SFTP

Secure File Transfer

SSH Keys

API

REST/SOAP endpoints

HTTPS + API Keys

VAN

Value Added Network

Provider-managed

Setup Instructions

1

Enable EDI Integration

  1. Navigate to Settings > Integrations
  2. Click Connect on the EDI card
  3. Configure your organization's EDI settings:
    • EDI ID (your identifier)
    • EDI Qualifier (ZZ, 01, etc.)
    • Company Name
2

Add Trading Partners

  1. Go to Settings > Integrations > EDI
  2. Click Add Trading Partner
  3. Enter partner details:
    • Partner Name
    • EDI ID
    • EDI Qualifier
    • Communication Method
3

Configure Communication

For AS2:

  • Exchange certificates with trading partner
  • Configure Partner AS2 ID and URL
  • Upload encryption and signing certificates

For SFTP:

  • Get SFTP credentials from partner
  • Configure host, port, username
  • Add SSH key or password
  • Set remote directory path

For API:

  • Get API endpoint from partner
  • Configure API URL and key
  • Set required headers
4

Test Connection

  1. Click Test Connection on the trading partner
  2. Send a test 997 acknowledgment
  3. Verify partner receives it

Sending EDI 210 (Invoice)

When a demurrage record is approved:

  1. Demurly generates EDI 210 with:
    • ISA/GS envelope with your IDs
    • B3 segment with invoice details
    • N9 segments with references
    • LX/L5/L0/L1 segments with line items
    • Totals in L3 segment
  2. Transmits via configured method
  3. Waits for 997 acknowledgment

EDI Format Reference

ISA Segment (Interchange Control Header)

ISA*00*          *00*          *ZZ*DEMURLYID      *ZZ*PARTNERID      *230115*1200*^*00401*000000001*1*P*:~
ISA05

Sender ID Qualifier

ISA06

Sender ID (your EDI ID)

ISA15

P=Production, T=Test

B3 Segment (Beginning Segment)

B3**INV-2023-001**PP**20230115*1250.00~
B302

Invoice Number

B307

Net Amount Due

L1 Segment (Rate and Charges)

L1*1*75.00*HR*150.00****DEM~
L103

Rate Qualifier (HR=Hourly)

L108

DEM=Demurrage

Security

  • All EDI transmissions encrypted (AS2/SFTP/HTTPS)
  • Trading partner credentials encrypted at rest
  • Full audit trail of all messages
  • 7-year retention for compliance

997 Acknowledgment Rejected?

Check the AK5 segment error codes:

  • Code 1: Segment missing - Check EDI mapping
  • Code 2: Element missing - Verify required fields
  • Code 3: Invalid value - Check data format
  • Code 4: Invalid date - Use CCYYMMDD format

Need Help?

EDI integrations require technical coordination. Our team is here to help with setup and troubleshooting.

Integrations Guide