Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

Username and password will be provided at the beginning of the project

Hostname

ftp.digitecgalaxus.ch

Protocol

SFTP

IP address

137.116.205.202

Port

22

Note

After a successful download/import, messages must be deleted from the FTP

Note

To avoid data loss in case of connection problems, the sender should check the successful upload and retransmit automatically if necessary

Note

Files should be uploaded with complete content, otherwise it can happen that our SystemTask downloads the files empty in case of time overlap.
If this is not possible or the files are first created empty on the FTP and only afterwards the content is written, the file name should be named temporarily with a prefix e.g. tmp_GDELR_*.xml.

The SSL certificate is renewed approx. every 2 years yearly and should be accepted automatically

If the password is sent incorrectly several times or too many requests are sent, the IP address will be blocked automatically temporary for 3 hours

Supported Key Exchange Algorithms:

Expand
titleList:

Supported Algorithms:

  • ecdh-sha2-nistp256

  • ecdh-sha2-nistp384

  • ecdh-sha2-nistp521

  • diffie-hellman-group-exchange-sha265

  • diffie-hellman-group18-sha512

  • diffie-hellman-group16-sha512

  • diffie-hellman-group14-sha256

Not supported Algorithms:

  • diffie-hellman-group-exchange-sha1

  • diffie-hellman-group14-sha1

  • diffie-hellman-group1-sha1

FTP folder structure

Test

dg2partner (IN)

sftp://ftp.digitecgalaxus.ch/OrderData/Test/dg2partner/

partner2dg (OUT)

sftp://ftp.digitecgalaxus.ch/OrderData/Test/partner2dg/

Live

dg2partner (IN)

sftp://ftp.digitecgalaxus.ch/OrderData/Live/dg2partner/

partner2dg (OUT)

sftp://ftp.digitecgalaxus.ch/OrderData/Live/partner2dg/

Transmission times of the messages

DELR:

  • Direct deliveries: latest 24h after dispatch

  • Warehouse deliveries: latest before warehouse delivery

INVO: earliest 48h before warehouse delivery

Filenaming

Galaxus -> Partner (dg2partner)

Order Placement (ORDP)

GORDP_<SupplierId>_<OrderId>.xml

Cancel Request (CANP)

GCANP_<SupplierId>_<OrderId>_<Timestamp>.xml

Return Registration (RETP)

GRETP_<SupplierId>_<OrderId>_<Timestamp>.xml

Partner -> Galaxus (partner2dg)

Order Response (ORDR)

GORDR_<SupplierId>_<OrderId>_<*>_<Timestamp>.xml

Dispatch Notification (DELR)

GDELR_<SupplierId>_<OrderId>_<*>_<Timestamp>.xml

Cancel Confirmation (CANR)

GCANR_<SupplierId>_<OrderId>_<*>_<Timestamp>.xml

Supplier Cancel Notification (EOLN)

GEOLN_<SupplierId>_<OrderId>_<*>_<Timestamp>.xml

Invoice (INVO)

GINVO_<SupplierId>_<OrderId>_<*>_<Timestamp>.xml

Export Invoice (EXPINV)

<OrderId>_<InvoiceNoPartner>_<TrackingNo>.pdf

Supplier Return Notification (SURN)

GSURN_<SupplierId>_<OrderId>_<*>_<Timestamp>.xml

The first characters correspond to the message designation, followed by an underscore:

  • <MessageType>: e.g. GDELR (Must)

  • <SupplierId>: Your Digitec Galaxus customer number - is also sent in the GORDP as supplier PARTY_ID, as well as in the file name (Should *)
    * = Must, if the same FTP account and folder is used for CH and EU

  • <OrderId>: Order number from Digitec Galaxus (Should)

  • <*>: Your document number (Should)

  • <InvoiceNoPartner>: Your invoice number (mandatory for export invoices)

  • <Timestamp>: Timestamp (Should)

Examples:

  • GORDP_<SupplierId>_<OrderId>.xml

  • GORDR_<SupplierId>_71696740_AB123456_202103311537.xml

  • GDELR_<SupplierId>_71696740_LF789000_202103311537.xml

  • GINVO_<SupplierId>_71696740_RG7654321_202103311537.xml

Info

If different order numbers are sent in the Dispatch Notification or Invoice, the <OrderId> in the file name can be omitted or only the first one can be used.

The export timestamp ensures the uniqueness of the file. This is necessary because files with the same file name that have already been uploaded before are deleted by our SystemTask without being downloaded first.

Note

The following characters must not be used in the file name:

  • Space

  • * ? ! | \ / ' " { } < > ; , ^ ( ) $ ~