How does it work
This is a generic service which accepts a body containing the business-document (in any format) - and some url parameters the helps Link identifying partners, format type, etc.
Credentials / Security
The service does not require any credentials for the sender.
Security for this service is provided via the sender-partner in Link - using the "IP-Address" identification type.
On the sender-partner an identification of type "IP-Address" must be provided with the senders correct IP address.
If this is not set, a failed document will be created with error-code 99902 and a message saying: "No valid identification value of IP-Address for sender: [The given sender-id]"
Notice: Wildcards in IP addresses are currently not supported.
Proxy server
If the sender-partner is behind a proxy the IP address will be the one of the proxy server and the client IP address is typically located in a header field. In cases like this you should use a Link setting called ClientIpHeaderFields to specify the name of the header field. The Link Setting is documented here: Link Settings
Available url parameters
SenderEdiPortalId
Mandatory
The id of the sender-partner. Eg.: EP-0000010485
ReceiverEdiPortalId
Optional
The id of the receiver-partner. Eg: EP-0000010489
Optional
Default: Xml (if not specified Xml will be set as default)
Remarks: If this is set to "FlatFile" - FormatName is required.
See Format Types
Optional / Mandatory if FormatTypeName is set to "FlatFile"
VariantName
Optional
VersionName
Optional
Examples:
Sending a JSON file:
Example
CODE
http://link-to-receive-site.yourdomain.com/httphandler.ashx?SenderEdiPortalId=EP-0000010485&FormatTypeName=Json
// Raw request:
POST /httphandler.ashx
Content-Type: application/json
cache-control: no-cache
Accept: */*
accept-encoding: gzip, deflate
referer: https://www.yoursite.com/
{ "myinvoiceId": "105050", "something": "invoice" }
Sending an XML file:
CODE
http://link-to-receive-site.yourdomain.com/httphandler.ashx?SenderEdiPortalId=EP-0000010485&FormatTypeName=Xml
// Raw request:
POST /httphandler.ashx
Content-Type: application/xml
cache-control: no-cache
Accept: */*
accept-encoding: gzip, deflate
referer: https://www.yoursite.com/
<invoice> <invoicenumber>123456789</invoicenumber> <date>2019-03-15</date> </invoice>