Er komt een nieuwe versie van de nShift Transsmart Webservice WSDL definition beschikbaar en we willen je informeren over de mogelijke impact en de uitrolplanning van deze wijziging.
Let op: Als je verbinding maakt via onze REST API, ook bekend als APIv2, of de MyTranssmart dashboard, dan heeft deze wijziging no impact.
Als je verbinding maakt via ons WSDL webservice-endpoint, is er slechts één scenario dat impact kan hebben op je verbinding. De update zal not van invloed zijn op hoe je nShift Transsmart gebruikt. Of je nu integreert vanuit een standaard enterprise-applicatie (ERP/WMS) of een maatwerkoplossing hebt, de uitwisseling van informatie blijft ongewijzigd.
Het scenario om rekening mee te houden
Sommige enterprise-systemen voeren een strikte controle uit op de exacte inhoud van de WSDL. Als de WSDL verandert en je systeem hier niet op is voorbereid, zal dit fouten veroorzaken en het boeken van zendingen verhinderen. Op basis van onze kennis worden de volgende systemen niet beïnvloed: Exact Online, Magento2, AFAS Profit 7, NAV ShipIt 4, Microsign. Voor alle andere bronsystemen: neem contact op met je systeembeheerder om te bevestigen of er een strikte controle op de WSDL wordt uitgevoerd en of dit je integratie kan beïnvloeden.
De controle kan worden uitgevoerd op onze acceptance-omgevingen, twee weken voordat we naar productie gaan. De nieuwe WSDL wordt op onze omgevingen geactiveerd op de volgende momenten:
- Beta: dinsdag 14 januari 2025
- Acceptance: dinsdag 14 januari 2025
- Production: maandag 27 januari 2025
Je vindt de nieuwe versie van de WSDL hier:
- https://beta-connect.transsmart.com/TboxService/2_0?wsdl
- https://accept-connect.transsmart.com/TboxService/2_0?wsdl
Opmerking: Deze wijziging zal ook worden doorgevoerd in de API en MyTranssmart op maandag 27 januari 2025 naar Acceptance en dinsdag 28 januari 2025 naar Production en zal worden vermeld via de reguliere release notes.
Wijzigingen in de WSDL in de sectie deliveryNoteLines:
| Field name | Type | Example |
| Returnable |
boolean: |
<n2:returnable>true</n2:returnable> |
| Attributes |
lijst met strings: |
<n2:attributes> <n2:attribute> <n2:name>Colour</n2:name> <n2:value>Blue</n2:value> </n2:attribute> <n2:attribute> <n2:name>Size</n2:name> <n2:value>XXL</n2:value> </n2:attribute> </n2:attributes> |
Achtergrond
We hebben een integratie met nShift Returns en bij het verzenden van zendinggegevens van nShift Transsmart naar nShift Returns hebben we de mogelijkheid nodig om aan te geven of een product retourneerbaar moet zijn of niet. Aangepaste producten kunnen bijvoorbeeld meestal niet worden geretourneerd. Daarnaast moeten we gedetailleerde produkteigenschappen/-specificaties kunnen doorgeven, zoals kleur of maat, om het voor consumenten gemakkelijker te maken het juiste product te selecteren dat zij in het Returns-platform willen retourneren.