Denne tjenesten håndterer en retur i systemet. Dersom årsaks-koden tilsier det vil abonnementet bli stoppet og åpen faktura kanselleres.
Webservice URI:/client/clientId/productReturn
HTTP-metode: POST
(eksempel: /client/1/productReturn)
Eksempel på input:
<?xml version="1.0" encoding="UTF-8"?> <productReturns> <productReturn> <companyCode>EGSF</companyCode> <invoiceNumber>123456</invoiceNumber> <returnReason>STOP</returnReason> </productReturn> <productReturn> <companyCode>EGSF</companyCode> <invoiceNumber>341256</invoiceNumber> <returnReason>OTHER</returnReason> </productReturn> </productReturns>
Beskrivelse av de forskjellige XML-elementene når du skal registrere en retur:
Elementnavn | Elementets forelder (parent) | Elementbeskrivelse | Datatype |
---|---|---|---|
<productReturns> | - | Rot-element - Dette er rot-elementet som inneholder alle retur-elementene | - |
<productReturn> | <productReturns> | Hoved-element - Dette angir en retur, du kan ha n antall <productReturn> elementer som barn av <productReturns> elementet i et XML dokument. | - |
<companyCode> | <productReturn> | Firma Angir firmakoden som faktura er knyttet til. | Tekst - maks 12 tegn |
<invoiceNumber> | <productReturn> | Faktura-nummer Unik ID innenfor firma-koden for en faktura. | Heltall |
<returnReason> | <productReturn> | Retur-kode Kode som angir hvordan retur skal håndteres. STOP - abonnement stoppes og faktura kanselleres. Alle andre verdier ignoreres. | Tekst - maks 12 tegn |
Svar:
<?xml version="1.0" encoding="UTF-8"?> <productReturns> <productReturn> <companyCode>EGSF</companyCode> <invoiceNumber>123456</invoiceNumber> <result>OK</result> </productReturn> <productReturn> <companyCode>EGSF</companyCode> <invoiceNumber>341256</invoiceNumber> <result>OK</result> </productReturn> </productReturns>
Beskrivelse av de forskjellige XML-elementene i et svar fra CWS når du har registrert en retur:
Elementnavn | Elementets forelder (parent) | Elementbeskrivelse | Datatype |
---|---|---|---|
<productReturns> | - | Rot-element - Dette er rot-elementet som inneholder alle retur-elementene | - |
<productReturn> | <productReturns> | Hoved-element - Dette angir en retur, du kan ha n antall <productReturn> elementer som barn av <productReturns> elementet i et XML dokument. | - |
<companyCode> | <productReturn> | Firma Angir firmakoden som faktura er knyttet til. | Tekst |
<invoiceNumber> | <productReturn> | Faktura-nummer Unik ID innenfor firma-koden for en faktura. | Heltall |
<result> | <productReturn> | Resultat OK dersom input ble behandlet ok. NO ACTION dersom ukjent retur-kode. Ellers, ERROR med en beskrivende feilmelding. | Tekst |