Sending documents
To send a document to your trading partner via the Edisoft platform, use the API command ‘Send’. The request must include the parameters described in the table:
|
Parameter |
Description |
Mandatory |
| Name | Login name | Yes |
| Password | Password | Yes |
| PartnerIln | ILN / GLN number of your partner | No |
| DocumentType | The type of document you are sending (ORDER, INVOICE, DESADV, RECADV, etc.) | No |
| DocumentContent | The complete Edisoft XML format document is embedded inside the CDATA | No |
Example of a request using the 'Send' command
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:wsedi">
<soapenv:Header/>
<soapenv:Body>
<urn:Send>
<urn:Name>SomeName</urn:Name>
<urn:Password>SomePassword</urn:Password>
<urn:PartnerIln>2000000000110</urn:PartnerIln>
<urn:DocumentType>ORDER</urn:DocumentType>
<urn:DocumentContent><![CDATA[…SomeContent…]]></urn:DocumentContent>
<urn:Timeout>100</urn:Timeout>
</urn:Send>
</soapenv:Body>
</soapenv:Envelope>
After executing the ‘Send’ command, the document is transferred to the Edisoft system and a response is sent, which contains the following fields:
|
Parameter |
Description |
| <ns1:cnt> | If the sending is successful, the ID assigned to the document is received. |
| <ns1:res> | If the sending fails, an error code is returned. |
Possible error codes and their descriptions:
| Error code | Description |
|---|---|
| 00000000 | API operation completed successfully |
| 00000001 | Authentication error |
| 00000003 | Invalid parameters |
| 00000004 | There is no such connection |
| 00000005 | The request timed out |
| 00000006 | System error |
Example of a response using the ‘Send’ command
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soapenv:Body>
<SendResponse xmlns="urn:wsedi">
<ns1:SendResult xmlns:ns1="urn:wsedi">
<ns1:Res>00000000</ns1:Res>
<ns1:Cnt>21823756</ns1:Cnt>
</ns1:SendResult>
</SendResponse>
</soapenv:Body>
</soapenv:Envelope>