BarcodeShipping
Get Started
Über uns
YBM-Deutschland
Yotta Byte Manager GmbH
Obere Münsterstraße 4
44575 Castrop-Rauxel


© 2018 BarcodeShipping – Die Versandlösung für den Onlineshop
Sie möchten eine Verbindung zwischen BarcodeShipping und Ihrer Datenbank herstellen? Das BarcodeShipping Modul „Database Shop“ ist Ihre Lösung.
Mit „Database Shop“ können Sie Ihre Bestellungen und die dazugehörigen Artikel/Positionen aus Ihrer Datenbank in BarcodeShipping per SQL abfragen, anzeigen lassen und verarbeiten.
Nach erfolgreichem Versand ist es ebenso möglich, die Bestellung oder die Artikeldaten zu aktualisieren, z.B. durch UPDATE oder INSERT Statements.
„Database Shop“ kann sich mit jeder Datenbank verbinden, für die ein JDBC-Treiber existiert z.B.:
– MySQL / MariaDB
– MS SQL
– Postgre SQL
Folgende Platzhalter können in den Abfragen und Statements verwendet werden:
:orderId
:orderNumber
:trackingNumber
:shipment.orderNumber
:shipment.orderId
:shipment.shipmentNumber
:shipment.trackingNumber
:item.sku
:item.ean
:item.id
:item.quantityInParcel
:item.quantityComplete
:item.quantityRemaining
Es gibt aktuell 5 Abfragen und Statements:
Diese Abfrage gibt alle Bestellungen/Aufträge zurück, die versendet werden dürfen. Die offenen Bestellungen werden in BarcodeShipping in der Bestellübersicht angezeigt.
Aufbau:
Feld | Datentyp | required | Beschreibung Folgend sind die Anforderungen für die Felder beschrieben, die in den Ergebnismengen der SQL-Abfragen enthalten sein und einem bestimmten Datentypen entsprechen müssen. |
orderId | String | Eindeutiger Schlüssel zur Identifikation einer Bestellung. In der Datenbank ist das ein Primärschlüssel. | |
orderNumber | String | Eindeutiger oder zusammengesetzter Schlüssel zur Identifikation einer Bestellung. Nicht erforderlich, wenn orderId als Primärschlüssel eine Bestellung referenziert. | |
state | String | ||
status | String | required | Status der Bestellung, wie z. B. „PROCESSING“, „CLOSED“, „unfulfilled“, … |
shippingMethod | String | Versandart/Versandprodukt | |
paymentMethod | String | Zahlungsmethode | |
quantity | BigDecimal | Menge | |
countryCode | |||
createdAt | LocalDateTime | ||
updatedAt | LocalDateTime | ||
orderedAt | LocalDateTime | ||
shipToName | String | Empfänger | |
shipToCountry | CountryCode | Bestimmungsort als Ländercode, z.B. „DE“ oder „DEU“ |
2. Order Query
Diese Abfrage gibt die Bestelldaten und Bestelldetails einer bestimmten Bestellung zurück. Dazu muss der BarcodeShipping Platzhalter (z. B. :orderNumber) im SQL-Statement in der „where“ Bedingung bestimmt und initialisiert werden.
Aufbau:
Feld | Datentyp | required | Beschreibung |
orderId | String | required | Eindeutiger Schlüssel zur Identifikation einer Bestellung. In der Datenbank ist das ein Primärschlüssel. |
orderNumber | String | required | Eindeutiger oder zusammengesetzter Schlüssel zur Identifikation einer Bestellung. Nicht erforderlich, wenn orderId als Primärschlüssel eine Bestellung referenziert. |
reference | String | required | Eindeutiger oder zusammengesetzter Schlüssel zur Identifikation einer Bestellung. Nicht erforderlich, wenn orderId als Primärschlüssel eine Bestellung referenziert. |
customerId | String |
| Kundennummer |
shopId | String |
|
|
language | String |
|
|
status | String | required | Status der Bestellung, wie z. B. „PROCESSING“, „CLOSED“, „unfulfilled“, … |
paymentMethod | String |
| Zahlungsmethode |
shippingMethod | String |
| Versandart/Versandprodukt; Versender |
shippingMethodDescription | String |
| Versandbeschreibung |
shipperService | String |
| Versandart/Versandprodukt |
currency | CurrencyCode | required | Währungscode, z. B. „EUR“ |
codAmount | BigDecimal |
|
|
createdAt | LocalDateTime |
|
|
updatedAt | LocalDateTime |
|
|
orderedAt | LocalDateTime |
|
|
|
|
|
|
shipToCompany | String |
| Firmenname des Empfängers |
shipToPrefix | String |
|
|
shipToFirstName | String | required | Vorname des Empfängers |
shipToMiddleNme | String |
|
|
shipToLastName | String | required | Nachname des Empfängers |
shipToSuffix | String |
|
|
shipToStreet | String | required | Straße der Empfängeranschrift |
shipToHouseNumber | String | required | Hausnummer der Empfängeranschrift |
shipToAdditionalLines | String |
| Adresszusatz |
shipToPostcode | String | required | Postleitzahl der Empfängeranschrift |
shipToCity | String | required | Stadt der Empfängeranschrift |
shipToCountry | CountryCode | required | Bestimmungsort als Ländercode, z. B. „DE“ oder „DEU“ |
shipToEmail | String |
| Die E-Mail-Adresse des Empfängers ist für das Zolldokument CN23 erforderlich. |
shipToPhone | String | required | Rufnummer des Empfängers |
|
|
|
|
billToCompany | String |
| Firmenname des Rechnungsempfängers |
billToPrefix | String |
|
|
billToFirstName | String |
| Vorname des Rechnungsempfängers |
billToMiddlenNme | String |
|
|
billToLastName | String |
| Nachname des Rechnungsempfängers |
billToSuffix | String |
|
|
billToStreet | String |
| Straße der Rechnungsempfängers |
billToHouseNumber | String |
| Hausnummer der Rechnungsempfängers |
billToAdditionalLines | String |
| Adresszusatz |
billToPostcode | String |
| Postleitzahl der Rechnungsempfängers |
billToCity | String |
| Stadt der Rechnungsempfängers |
billToCountry | CountryCode |
| Bestimmungsort als Ländercode, z. B. „DE“ oder „DEU“ |
billToEmail | String |
| E-Mail-Adresse des Rechnungsempfängers |
billToPhone | String |
| Rufnummer des Rechnungsempfängers |
3. Order Item Query
Diese Abfrage gibt die Artikeldetails eines einzelnen Artikels wieder. Sie wird dazu verwendet, um Artikeldaten wie SKU, Herstellungsland, Zolltarifnummer, Gewicht, Zollwert oder Bestellmenge zu laden.
Feld | Datentyp | required | Beschreibung Folgend sind die Anforderungen für die Felder beschrieben, die in den Ergebnismengen der SQL-Abfragen enthalten sein und einem bestimmten Datentypen entsprechen müssen. |
itemId | String | required | Eindeutiger Schlüssel zur Identifikation eines Artikels. |
sku | String | required | Artikelnummer |
ean | String | required | EAN des Artikels |
name | String | required | Positionsbeschreibung |
country | CountryCode | required | Ländercode, z. B. „DE“ oder „DEU“ |
commodityCode | String | required | Zolltarifnummer |
manufacturer | String | ||
manufacturerCode | String | ||
price | BigDecimal | required | Einzelpreis |
taxPercent | BigDecimal | Steuersatz | |
weight | BigDecimal | required | Gewicht |
warehouse | String | ||
storageArea | String | ||
adult | Boolean | Güter für Erwachsene | |
alcohol | Boolean | Güter mit alkolischen Inhaltsstoffen | |
limitedQuantityHazardousMaterial | Boolean | Güter mit biologischen Inhaltsstoffen | |
perishables | Boolean | Verderbliche Güter | |
plants | Boolean | Güter mit pflanzlichen Inhaltsstoffen | |
seeds | Boolean | Saatgut | |
specialException | Boolean | Güter mit Sondergenehmigung | |
tobacco | Boolean | Tabakwaren | |
quantityInvoiced | BigDecimal | Anzahl der berechneten Stückzahl | |
quantityOrdered | BigDecimal | required | Bestellmenge |
quantityShipped | BigDecimal | required | Liefermenge (immer 0, wenn es keine Teilsendung gibt) |
4. Order Update Statement
Kann frei formuliert und genutzt werden, um z.B. ein UPDATE oder INSERT Statement auszuführen. Beispielsweise, um einer Bestellung eine Trackingnummer hinzuzufügen oder den Status einer Bestellung anzupassen.
5. Order Item Update Statement
Kann frei formuliert und genutzt werden, um ein UPDATE oder INSERT Statement auszuführen. Beispielsweise, um den Bestand eines Artikels oder den Versandstatus zu aktualisieren.
Die Verbindung ist hergestellt und Sie können Ihre Bestellungen in BarcodeShipping sehen?
Nun können Sie für Ihre Bestellungen Versandlabel erstellen und diese wie gewohnt verschicken.
YBM-Deutschland
Yotta Byte Manager GmbH
Obere Münsterstraße 4
44575 Castrop-Rauxel