HttpHandler.ashx

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

FormatTypeName

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

FormatName

Optional / Mandatory if FormatTypeName is set to "FlatFile"

VariantName

Optional

VersionName

Optional

Examples:

Sending a JSON file:

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:

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>