Creating a return (createReturn)

Method name:

public ReturnResultApiBean createReturn(ReturnsApiBean returnsApiBean, String apiKey) 
throws MeestException;

Service request: ReturnsApiBean

Field name	Field type	Required	Description
idReturn	Long	N	Identyfikator zwrotu
idParcel	Long	Y	Identyfikator paczki w systemie Meest Polska
dispatchNumber	String	Y/N	Opis błędu lub komunikat o poprawnie wykonanej operacji
receiverAddress	AddressesEvidenceApiBean	N	Link do pobrania dokumentów celnych.
receiverName	String	Y	Nazwa odbiorcy
parcelBarCode	String	Y	BarCode przesyłki
parcelNumber	String	Y	Numer przesyłki w systemie partnera
returnsNumber	String	Y	Numer zwrotu
createDate	Date	Y	Data utworzenia
parcelWeight	Double	Y	Waga przesyłki
parcelPrice	Double	Y	Cena przesyłki
parcelValue	Double	Y	Cena przesyłki EUR
returnsStatus	ReturnsStatusEnum	Y	Possible values: ACCEPTED, REJECTED
returnsType	ReturnsTypeEnum	Y	Possible values: FULL, PARTIAL
returnsReason	ReturnsReasonEnum	Y	Possible values: NOT_DELIVERED, COMPLAINT, OTHER
returnsDetails	String	N	Detail for othertype return
moneyTransferType	MoneyTransferTypeEnum	Y	CARD_ADMISSION POSTAL_MONEY_TRANSFER BANK_MONEY_TRANSFER
parcelInternalNumber	String	Y	Wewnętrzny numer paczki
passportPlaceDate	String	N	Data i miejsce wydania paszportu
passportSeries	String	N	Seria paszportu
passportNumber	String	N	Numer paszportu
clientCode	String	N	Kod klienta
processDataAcceptation	String	Y	Zgoda na przetwarzanie danych osobowych
returnsDate	Date	Y	Data zwrotu
weight	Double	Y	Waga
valueEur	Double	Y	Wartość zwrotu w EUR
valueUah	Double	Y	Wartość zwrotu w UAH
valueWords	String	N	Wartość zwrotu słownie
notes	String	N	Notatki
phoneNumber	String	Y	Numer telefonu
bankCard	String	N	Numer konta bankowego
taxNumber	String	N	Kwota podatku
returnPositions	ArrayList<ReturnsPositionApiBean>	Y	Lista pozycji zwrotu
checkDeliveryCosts	Boolean	N	Uwzględnienie kosztów dostaw

Service Response ReturnResultApiBean

Field name	Field type	Required	Description
idReturn	Long	N	Unique return identifier
apiStatusEnum	ApiStatusEnum	Y	Result of method call. Possible values: OK, ERROR, VALIDATION_ERROR
errorDescription	String	Y/N	Description of error for status of error or validation
returnNumber	String	N	Unique return number

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:log="http://logic.meestgroup.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <log:createReturn>
         <arg0>
            <returnsDate>2020-06-15</returnsDate>
            <bankCard>1234123412341234</bankCard>
            <!-- required -->
            <idParcel>475800</idParcel>
            <!--CARD_ADMISSION,BANK_MONEY_TRANSFER,POSTAL_MONEY_TRANSFER  -->
            <moneyTransferType>CARD_ADMISSION</moneyTransferType>
            <parcelBarCode>CV844776801CZ</parcelBarCode>
            <parcelInternalNumber>37507/269/01</parcelInternalNumber>
            <parcelNumber>CV844776801CZ</parcelNumber>
            <passportNumber>12345678</passportNumber>
            <passportPlaceDate>Kielce, 12-06-1990</passportPlaceDate>
            <passportSeries>ABC 123455</passportSeries>
            <phoneNumber>123123123</phoneNumber>
            <processDataAcceptation>true</processDataAcceptation>
            <receiverAddress>
               <apartment>1</apartment>
               <city>Kielce</city>
               <country>PL</country>
               <email>marek.duda@smartive.app</email>
               <house>1</house>
               <name>Marek</name>
               <phone>123123123</phone>
               <postCode>22-222</postCode>
               <postOffice>Kielce</postOffice>
               <street>uliczna</street>
            </receiverAddress>
            <receiverName>Marek D</receiverName>
            <returnPositions>
               <brand>brand</brand>
                <!--exact value as from parcel position -->
               <count>10</count>
               <countryCode>PL</countryCode>
               <customsCode>84713000</customsCode>

               <name>name</name>
               <nameUk>name UA</nameUk>
                <!--exact value as from parcel position -->
               <productEan>000342273448794</productEan>
               <productSize>XXL</productSize>
               <!--INCORRECT_SIZE,INCORRECT_PRODUCT,POOR_QUALITY,RECLAMATION,OTHER -->
               <returnsPositionReason>INCORRECT_SIZE</returnsPositionReason>
                <!--exact value as from parcel position -->
               <valueEur>1230</valueEur>
               <valueUah>12300</valueUah>
               <weight>1</weight>
            </returnPositions>
            <returnsBarcode>returnBarcode</returnsBarcode>
            <!--NOT_DELIVERED,COMPLAINT,OTHER -->
            <returnsReason>COMPLAINT</returnsReason>
            <!-- REJECTED, ACCEPTED-->
            <returnsStatus>ACCEPTED</returnsStatus>
            <!--FULL, PARTIAL -->
            <returnsType>FULL</returnsType>
            <valueEur>10</valueEur>
            <valueUah>1000</valueUah>
            <weight>1</weight>
         </arg0>
         <arg1>45d91722-a9b2-456a-8bbf-8e28a5db5fd3</arg1>
      </log:createReturn>
   </soapenv:Body>
</soapenv:Envelope>