WebStamp web service: SOAP

Back

WebStamp web service: SOAP

Close

    WebStamp web service: SOAP

    Version V06.05 – November 2020

    Version V06.04 June 2020

    Version V06.03 - June 2019

    1 Introduction

    The Web service WebStamp allows you to fully integrate WebStamp into another application. The interface is available in the variant: SOAP.

    1.1 SOAP specification

    Detailed descriptions of each SOAP method, such as field data type, can be found in the WSWL and are not repeated in this document

    1.2 Definition of terms

    Term Description
    Customer A customer is a user of the WebStamp online service via the WebStamp web service or Webstamp light interfaces. The customer must be registered with Swiss Post in order to use WebStamp
    Integrator, platform provider A company, organization or person who has connected WebStamp to their own platform using WebStamp web service or Webstamp light.
    Application ID, provider number Each application identifies itself to WebStamp with a unique key:
    WebStamp web service access uses the application ID
    Customer Centre Log-in Various online services are grouped under the Swiss Post “Customer Center” and can be accessed with a single
    username and password.
    Only one centralized registration is required for the Swiss Post “Customer Center”, and this also allows you to use
    “WebStamp”.
    WS Abbreviations for “WebStamp”
    WSWS Abbreviations for “WebStamp web service”

    2 General

    2.1 Encoding

    The character coding for SOAP communication is always UTF-8.

    2.2 Versions

    The interface is available in a range of versions. This allows for better delimitation of existing and older interface versions as the product is developed. Over time, older versions will be discontinued by Swiss Post following prior notification of the end date.

    Please ask for exact details of the versions when managing the WebStamp application.

    The respective version numbers of the data fields are indicated in the tables. If there is no version number, they apply to all versions. Where a version number is specified, it applies to the specified version and all subsequent versions. If multiple versions are specified, the data field applies to the specified versions only.

    Attempting to call a version that is no longer valid returns HTTP status code 410.

    2.3 Currently available versions

    Version Description
    V6
    • Current and maintained version.
    V5
    • Available previous version. We recommend migrating to the latest version.

    2.4 Adjustments when changing versions

    Each time you update to a newer version, the URL must be adapted to the new version (see 2.7 Access data). New functions offered as a part of an audit can be activated by updating the WSDL.

    If the adjustment is not marked as mandatory, it provides additional functionality but is not necessarily required.

    Version

    Audit

    		 Mandatory Description

    V6

    		 05

    NO

    		 - Additional information on media types
    - Transfer of data from electronic customs declarations for international consignments containing goods

    V6

    04

    NO

    - Return note for registered letter mail
    - Electronic cash on delivery with QR-IBAN

    V6

    03

    NO

    - Additional creation of labels in ZPL2 format
    - Optional specification of resolution for receiving the labels (dpi)
    - Ordering of WebStamp using printing service
    - Processing of individual letters and mailshots

    V6

    02

    NO

    - Checking and redeeming discount codes
    - Detailed price information

    V6

    01

    NO

    - International recipient addresses can now be submitted without a postcode (zip).
    - Receipts can be obtained as XMLs
    V5 - Yes - Transition to new endpoints
    - Review of all implemented SOAP methods
    - Removal/migration of disabled WSWS functions (e.g. for parcels)
    - Adjustment of SOAP fault handling
    - Review of data structure names, which sometimes contained the API version

    2.5 Detailed description

    Default values are shown in italics in property lists

    2.6 WebStamp server

    Two independent infrastructures are available for the connection.

    Infrastructure Description
    https://wsredesignint1.post.chTarget not accessible Continuously expanded test environment for new releases of WebStamp.
    https://wsredesignint2.post.chTarget not accessible Stable test environment for new integrators or for test systems (production release level). This is the preferred platform for integrators.
    https://webstamp.post.ch/Target not accessible Productive system

    2.7 Access data

    The interface can be accessed using the following URL:

    V6

    <WebStamp Server>/wsws/soap/v6

    Identification with WS customer ID / web service password

    V5

    <WebStamp Server>/wsws/soap/v5

    Identification with WS customer ID / WSWS-Passwort

    2.7.1 Application identification

    An application ID is required for access by each application you want to connect to. This is assigned by Swiss Post.

    2.7.2 User ID

    The user must also be authenticated with a customer ID / WSWS-Passwort. The WS customer ID can be found on the WebStamp homepage under WebStamp Settings / WebStamp web service. This page can also be used to store the WSWS password.

    The identification using WS customer ID and WSB password must be transmitted with each request (except for the Options interface).

    Please note

    For an order (request), the following three attributes must be transferred to WebStamp:

    • Application ID
    • WS customer ID
    • WSWS password

    2.7.3 Signed connection

    In special cases, access can be implemented using signatures. In this case, Swiss Post issues a certificate to the integrator, which must be used to sign the connection (TLS) to WebStamp WebService.

    When using signed access, WebStamp only allows calls with a valid signature. Invalid or unknown signatures are rejected.

    For the connection, the host name for the WebStamp server is preceded by “cert.”. The following is an example of a signed call from a command line:

    curl https://cert.webstamp.post.ch/wsws/soap/v6Target not accessible
    --cert certificate.pem:”*******”
    --data @soap-request.xml

    Please note

    The default method is identification of the user with WS customer ID and WSWS password without signing. Implementation with signing must always be agreed in advance with those responsible.

    If this method of identification is chosen, the system can be set so that the WSWS password does not have to be transmitted.

    3 Authentication

    Each request to WebStamp must contain an identification container, which is used to authenticate the user.

    The customer ID and WSWS password must be used to verify the user’s identity. 

    3.1 wsws_identification

    Name Data type Description
    application string Identification hash of the calling application.
    language token Two-character language code. Determines the response language of the interface when texts are returned.
    Possible values:
    - de
    - fr
    - it
    - en
    [userid] string WS customer ID.
    [password] string WSWS password.
    [encryption_type] token Encryption of the WSWS-Passwort: md5 or sha1. If encryption_type is left empty or the attribute is not available,
    the WSWS-Passwort is transmitted as plain text.
    - md5
    - sha1
    - (Empty)
    Empty or attribute hash type not available (WSWS-Passwort is transmitted in plain text)

    4 Options

    The Options interface returns all supported product information and its configuration. This makes it easy to integrate new WebStamp products into a third party application and to query changes to products (e.g. price changes). If the products are not kept up to date, problems can arise when products are changed (for example a message to the customer that a requested product is no longer available).

    Unless otherwise noted, all functions in the Options interface can also be queried without a username and WSWS-Passwort. The application ID /provider number are sufficient.

    4.1 wsws_category

    Swiss Post products are grouped into product categories (e.g. domestic letters). The object wsws_category displays a product category with the relevant details.

    Name Data type Description
    number int Unique product category ID.
    name string Name of the product category.
    recipient_manatory boolean Determines whether the recipient’s address is mandatory or not.
    valid_days int Product validity in days

    4.2 wsws_product

    The object wsws_product contains a Swiss Post product with the relevant details.

    Please note
    • Swiss Post recommends the use of “post_product_number” for product identification. This changes less often than “number”. Regardless of which number is used, the integrator must recognize changed numbers in the application. The valid numbers are available from the Options interface. It is recommended to check this from time to time and react accordingly in the event of changes.
    • If a subsystem or subsystem/segment is specified for a product, a franking licence is required for the order (see section 4.8).
    • Product queries in the past are not supported.
    Name Data type Description
    number int Unique ID for the product. Changes each time the product is changed.
    category string Alias for the product category.
    category_number int Unique category number. For the values allowed, see 4.1. wsws_category
    post_product_number int Swiss Post number (level number for Swiss Post’s own applications).
    Similar to the number attribute. Unlike the number attribute, the Swiss Post number does not always change when a product is changed.
    price float Price of the product, including VAT.
    name string Name of the product.
    additions array Array with wsws_addition objects.
    delivery string Delivery type (e.g. A Mail, B Mail).
    format string Format (e.g. standard letter, midi letter)
    size_din string DIN ISO format (e.g. A4).
    max_size_length int Maximum length in mm.
    max_size_height int Maximum height in mm.
    max_edge_length int Maximum total dimensions.
    max_scale int Maximum scale (for bulky goods).
    max_weight int Maximum weight in grams.
    zone int Country zone
    For the values allowed, see 4.6 wsws_zone
    product_list string Name of the product range in the user’s language.
    product_list_number int Number of the product range.
    subsystem int Subsystem from which a franking licence is required.
    segment int Segment that describes a franking licence uniquely in conjunction with the subsystem.
    barcode boolean Indicates whether this is a letter with barcode (BMB) product. This information can be used to determine the print medium.

    4.3 wsws_addition

    The object wsws_addition displays all supported value-added services for a product.

    Name Data type Description
    code string Optional addition code.
    short_name strng Addition short name.

    4.4 wsws_media_type

    The object wsws_media_type contains a print media type (e.g. labels, envelopes, etc.).

    Name Data type Description
    number int Unique ID of the media type.
    name string Name of the media type.
    image_possible boolean Indicates whether or not an image is allowed.

    printservice_possible

    boolean

    Indicates whether the medium type for the WebStamp printing service can be used.

    ead_possible

    boolean

    		 Indicates whether the medium type can be used for international consignments containing goods (and electronic reporting of data).

    zpl_support

    boolean

    		 Indicates whether the print media of this medium type can be used when utilizing the Zebra Label Printer and file_type zpl
    categories array An array with wsws_category objects. Specifies the category for which this media type is available.

    4.5 wsws_media

    The object wsws_media contains a print medium (e.g. Zweckform 3659 label, C5 envelope, etc.).

    Name Data type Description
    number int Unique medium number.
    name string Name of the medium.
    type int Medium type. For the values allowed, see 4.4 wsws_media_type

    4.6 wsws_zone

    Swiss Post groups countries into a range of different zones. The object wsws_zone contains one of these zones.

    Name Data type Description
    number int Unique zone ID.
    name string Name of the zone.
    zone int 1: Zone 1 (Europe)
    2: Zone 2 (remaining countries)
    3: In Switzerland

    4.7 wsws_country

    The object wsws_country contains a country and its details. Countries return all known country codes and their names. The zone is also included. The country name is used with a table of countries to evaluate the relevant zone.

    Name Data type Description
    alias string International country alias.
    zone int Number of the corresponding zone. For the values allowed, see 4.6 wsws_zone
    name string Country name (in full).

    4.8 wsws_license

    The object wsws_license displays the franking licence and the customer comments associated with it. Customers can identify their franking licence using the combination of “number” and “comment” displayed to them. The “number” attribute is used for the handover to the “new_order” method.

    Please note
    • The WS customer ID and WSWS password are required to query the franking licence. (If working with signing, see 2.7.3).
    • If a subsystem or subsystem/segment is specified for a product (see section 4.2), a franking licence is required for the order.
    Name Data type Description
    number string Customer’s franking licence (franking licence assigned by Swiss Post to the customer).
    comment string Customer’s comments on the franking licence (can be left empty).
    subsystem int Subsystem for mapping to products.
    segment int The segment is used in conjunction with the subsystem.

    4.9 wsws_product_list

    Describes a queried product range.

    Name Data type Description
    number int ID of the product range.
    name string Description of the product range.
    customer_type token Customer type of the product range. (bc = business customers, pc = private customers)

    4.10 wsws_customer_data

    Describes basic billing data and the product range for a customer.

    Name Data type Description
    license_state string Status of the customer’s franking licence (FrL):
    none Does not have own FrL
    pending FrL application open
    rejected FrL application rejected
    ok Valid FrL
    payment_type string Customer’s billing method:
    prepaid In advance
    kurepo Invoice customer
    product_lists array Array of IDs of the customer’s product ranges.

    5 Order

    All complex data types listed below belong to the actual order itself. They group together all the information required for an order or define the response structure for an order.

    5.1 wsws_address

    The object wsws_address represents an address.

    Name Data type Description
    [organization] string Company or organization.
    [company_addition] string Company suffix
    [title] string Salutation
    [firstname] string First name
    [lastname] string Last name
    [addition] string Additional details
    [street] string Street, including number.
    [pobox] string P.O. Box including optional number.
    The P.O. Box number can be appended or the attribute “pobox_nr” can be transmitted.
    [pobox_lang] string Language code for the P.O. Box:
    de German (Postfach)
    fr French (case postale)
    it Italian (casella postale)
    en English (P.O. Box)
    The language code is only used if the attribute “pobox” is not specified.
    [pobox_nr] string P.O. Box number
    The number is only transferred if one of the attributes “pobox” or “pobox_lang” contains a valid value.
    [zip] string Postcode
    city string Town
    [country] string Country code (default: ch) or name of the country.
    These values are not case-sensitive.
    [reference] string The reference transmitted here refers to the order and is returned in the order result.
    It is used as the implementer’s own order reference. The value transmitted has no other function on the WebStamp site. It is transmitted only by the request to the response.
    [company_addition] string Additional details for companies and organizations.
    [cash_on_delivery_amount] float COD charge for each recipient address for cash on delivery.
    For floating point numbers, the amount must be rounded off for accounting purposes.
    [cash_on_delivery_esr] string ISR reference number for each recipient address for cash on delivery with ISR.
    [cash_on_delivery_qr_ref] string QR reference for each recipient address of a cash on delivery order with the QR-IBAN account type.
    [print_address] string Multiple line address for the recipient overprint. If transmitted, it is used instead of the individual fields.

    5.2 wsws_order

    The object wsws_order contains the order with the relevant details.

    Name Data type Description
    order_id int Unique order number.
    print_data base64
    • If the order is a PDF or ZPL, which is ordered by specifying a print medium and with the attribute single TRUE, the print data is outputted at order level. Otherwise, the individual print data is held in the stamps container.
    stamps array Array with wsws_stamp objects.
    • consignments
    • array
    • Array with wsws_consignments objects.
    messages array Array with wsws_message objects.
    reference string Reference value transmitted for the order. Used to identify the order to the integration software.
    Has no other function in WebStamp, simply transmitted.
    price float Total order price including VAT.
    price_details array Array with wsws_price_detail objects.
    item_price float Item price per product including VAT.
    valid_days int Number of days until the postal prepayment impressions for the order become invalid.
    valid_until dateTime Expiry date for the postal prepayment impressions in this order.
    delivery_receipt base64 Delivery note as a PDF (if available).
    product_number int Internal WebStamp product ID for this order that is effectively used.
    post_product_number int Swiss Post product number for this order that is effectively used.

    5.3 wsws_stamp

    This object represents the actual postal prepayment impression with the relevant details.

    Name Data type Description
    stamp_id int Unique postal prepayment impression number.
    tracking_number string For letters with barcode, the consignment number is returned for the Track & Trace system.
    print_data base64
    • Individual postage paid impression per stamp. Is empty if the query was made by specifying a print medium and using the single TRUE attribute.
    compression token Image compression (gzip or empty).
    mime_type string Mime type for franking.
    image_width_mm int Width of the image in millimetres.
    image_height_mm int Height of the image in millimetres.
    image_width_px int Width of the image in pixels.
    image_height_px int Height of the image in pixels.
    reference string Reference value transmitted for the recipient’s address.

    5.4 wsws_message

    wsws_message is used to send messages to the customer (for example new General Terms and Conditions).

    Name Data type Description
    message_type int The type indicates the type of message:
    - announcement
    - error
    - confirm
    customer_message string Message to be displayed to the user.
    system_message int Technical message for the integrator.
    system_message_code int Number of system_message.
    url string Additional link if the message must be confirmed, for example in a web GUI.
    confirm_until dateTime Date by which a message of the type “confirm” must be confirmed.

    Messages of the type “confirm” contain important information and must be confirmed by the customer within a specified period (for example new General Terms and Conditions). If the deadline expires, the customer cannot place any further orders until the message is confirmed. The integrator must be capable of handling this functionality.

    Messages of the type “announcement” do not need to be confirmed. This type is used to send important information for end customers.

    5.5 wsws_cash_on_delivery

    This object contains the information for a COD order.

    Name Data type Description
    transaction_type token Account type for the beneficiary. “post_bank” , “esr” or “qr_iban” are supported.
    esr_customer_ number int ISR participant number of the beneficiary for transaction_type ’esr’.
    iban string IBAN of the beneficiary for transaction_type ’post_bank’.
    qr_iban string QR-IBAN account number of the end beneficiary for transaction_type “qr_iban”
    beneficiary wsws_address Address information for the beneficiary for transaction_type ’post_bank’.

    5.6 wsws_custom_media

    This object is required to transmit a custom print medium. All dimensions are in mm.

    Please note

    The print area required for a label depends on a range of components (e.g. product selection, use of recipient addresses, use of images, etc.). The minimum dimensions for the print area depend on how the various components are used.

    For custom formats, a check is made to ensure that the minimum dimensions are available. If they are not, the print area is too small and a message is output.

    Name Data type Description
    type enum - label
    - envelope
    - letter
    - paper
    page_width int Page width
    page_height int Page height
    [margin_top] int Top margin
    [margin_bottom] int Bottom margin
    [margin left] int Left margin
    [margin right] int Right margin
    [cols] int Labels per row (only for type=label)
    [rows] int Labels per column (only for type=label)
    [colspacing] int Bar width (only for type=label)
    [rowspacing] int Bar height (only for type=label)
    [recipient_orientation] enum Recipient orientation to one of the following points
    - top/left
    - top/right
    - bottom/left
    - bottom/right
    [recipient_x] int Recipient position horizontal (only if type!=label)
    [recipient_y] int Recipient position vertical (only if type!=label)
    [sender_orientation] enum ender orientation to one of the following points
    - top/left
    - top/right
    - bottom/left
    - bottom/right
    [sender_x] int Sender position horizontal (only for type!=label)
    [sender_y] int Sender position vertical (only for type!=label)
    [franking_orientation] enum Franking orientation to one of the following points
    - top/left
    - top/right
    - bottom/left
    - bottom/right
    [franking_x] int Franking position horizontal (only for type!=label)
    [franking_y] int Franking position vertical (only for type!=label)

    5.7 wsws_order_item

    The object contains the relevant information for a single postal prepayment impression.

    Name Version Data type Description
    stamp_id V6 int Unique ID of the postal prepayment impression.
    label_number V6 int Serial number, which is printed on the postal prepayment impression.
    tracking_number V6 string For letters with barcode, the consignment number is returned for the Track & Trace system.

    5.8 wsws_price_detail

    The object contains the price details per order. The sum of all amounts equals the total order amount.
    This information is required if discount codes or additional services are offered.

    Name Version Data type Description
    type V6 enum The type of order item. The following values are possible:
    - webstamp: the order item of the WebStamp labels at list price (postage amount)
    - discount: the reduction granted when a discount code is redeemed
    - charge: a value-added service on the order which is not included on the price list (e.g. printing service charges)
    quantity V6 int The quantity of the order item.
    amount V6 float The amount of the order item. When a discount code is used, a negative amount will be returned.
    description V6 string The description of the order item, e.g. the product name or the name of the discount group.

    5.9 wsws_consignments

    • Within an order of individual letters and mailshots, the object supplies information concerning the consignments found in the document and their pages, and shows the allocation of consignments to stamps.

     

    • Name
    • Version
    • Data type
    • Description
    • stamp_id
    • V6
    • int
    • Assigned label ID from the wsws_stamps objects
    • number
    • V6
    • int
    • Serial number per consignment
    • pages
    • V6
    • array
    • Array with page objects in which the pages of the consignment are present with a serial page number.
    • window
    • V6
    • string
    • Position of the located recipient address in the transparent window:
      left On the left-hand side of the window area
      right On the right-hand side of the window area
    • state
    • V6
    • string
    • Consignment status:
      valid The consignment is compatible with the usedproduct
      invalid The consignment cannot be processed
    • reason
    • V6
    • string
    • If the status of a consignment is invalid, the reason for non-processing is returned.

    6 Info

    Information about past order processes can be obtained using the following complex data types.

    6.1 wsws_receipt

    This object contains the information for single or batch receipts. The data is returned by default in PDF format in the receipt container. Alternatively, the data can be requested in a structured form using the get_info_receipt method and returned in the receipt_info container.

    Name Version Data type Description
    order_id - int Unique ID for the order.
    receipt - base64 Receipt as PDF. Returned empty if the output for the request is requested in xml format.
    receipt_info V6 array Array of wsws_receipt_info objects, hence receipt data for the order. Returned empty if the output for the request is requested in xml format.

    6.2 wsws_receipt_info

    This object contains the detailed information including the order items for a receipt.

    Name Version Data type Description
    address V6 wsws_address The billing address for the receipt.
    journal V6 wsws_journal Summary order data.
    product V6 wsws_product The product used for the order.
    order_items V6 array Array of wsws_order_item objects.

    6.3 wsws_delivery_receipt

    This object contains the online delivery note.

    Name Data type Description
    order_id int Unique ID for the order.
    delivery_receipt base64 Delivery note as PDF.

    6.4 wsws_journals

    The journal contains the details of past orders. It can be ordered with restrictions on type (order via interface, order via GUI) and using a date horizon.

    Name Data type Description
    journals array Array with wsws_journal objects. Returned empty if the output for the request is requested in url format.
    messages int Array with wsws_message objects if the journal is requested in url format.

    6.5 wsws_journal

    In this object, the summary information for a previous order is returned.

    Name Data type Description
    date dateTime Date of order.
    order_id int Unique ID for the order.
    quantity int Number of postal prepayment impressions.
    price float Item price including VAT.
    total_price float Total price including VAT.
    valid_until dateTime Date up to which the order is valid.
    order_comment string The order note saved with the order.

    7 SOAP methods

    7.1 Options

    The options request can be used to query all options available in WebStamp web service. A separate SOAP method is available for each option group. To query all options, all SOAP methods must be called up. It is recommended to store the options locally and query them only occasionally.

    The timestamp and categories parameters is always optional. If they are not transmitted, the current time is assumed for timestamp and all available categories are assumed.

    7.1.1 get_categories

    Returns all supported categories.

    Parameters
    Name Data type Description
    identification wsws_identification Identification object.
    Return
    Name Level Description
    categories array Array with wsws_category objects.

    7.1.2 get_products

    Returns the available products. The data returned can be limited by product category and timestamp.

    Parameters 
    Name Data type Description
    identification wsws_identification Identification object.
    [timestamp] dateTime Time of validity of the requested data. This can be used for example to query data in the future.
    post_product_number int Internal Swiss Post product number.
    customer_type token Customer type of the product range. (bc = business customers, pc = private customers)
    product_lists array One or more product range numbers to limit the product search.
    Return
    Name Level Description
    products array Array with wsws_product objects.

    7.1.3 get_media_types

    Returns the available media types. The data returned can be limited by product category and timestamp.

    Parameters
    Name Data type Description
    identification wsws_identification Identification object.
    [timestamp] dateTime Time of validity of the requested data. This can be used for example to query data in the future.
    Return
    Name Level Description
    media_types array Array with wsws_media_type objects.

    7.1.4 get_medias

    Returns the available media. The data returned can be limited by timestamp.

    Parameters
    Name Data type Description
    identification wsws_identification Identification object.
    [timestamp] dateTime Time of validity of the requested data. This can be used for example to query data in the future.
    • [type]
    • int
    • Restriction of the print media to one media type. The number of the media type is queried using the get_media_types method.
    Return
    Name Level Description
    medias array Array with wsws_media objects.

    7.1.5 get_zones

    Returns the available country zones.

    Parameters
    Name Data type Description
    identification wsws_identification Identification object.
    Return
    Name Level Description
    zones array An array with wsws_zone objects.

    7.1.6 get_countries

    Returns the available countries. The zone is also included. The country name is used with a table of countries to evaluate the relevant zone.

    Parameters
    Name Data type Description
    identification wsws_identification Identification object.
    Return
    Name Level Description
    countries array Array with wsws_country objects.

    7.1.7 get_licenses

    Business customers can now specify a personal franking licence for certain products. Franking licences allow the customer to order certain additional products, and are also used for billing the order. Each franking licence can be used for one product type only.
    It is not possible for the integrator to make this distinction – customers must select the appropriate franking licence themselves. Alternatively, a product number (type: post_product_number) can be specified in the franking licence query to limit the selection of licences. Theoretically, a customer’s franking licences can change with every order, so they should be stored with care.

    Parameters
    Name Data type Description
    identification wsws_identification Identification object.
    [post_product_number] int Internal Swiss Post product number (level number)
    Return
    Name Level Description
    licenses array Array with wsws_license objects.

    7.1.8 get_product_lists

    Returns the various product ranges. The product ranges are divided into two main categories in WebStamp: “pk” (private customers – pc) and “gk”(business customers – bc), and there are further subdivisions in each category. A customer can be assigned to multiple product ranges, but only to one main category (pc or bc). By specifying customer_type, you can query the product ranges relevant for your users. If the parameter is transmitted empty, all product ranges are returned.

    If a valid user login is specified in the identification object, customer_type is ignored and the product ranges assigned to the customer are returned instead. Queried product range numbers can be included with get_products to limit the product query by range(s).

    All queries are limited to currently valid product ranges.

    Parameters
    Name Data type Description
    identification wsws_identification Identification object.
    [customer_type] token Customer type of the product range. (bc = business customers, pc = private customers)
    Return
    Name Level Description
    product_lists array Array with wsws_product_list objects

    7.1.9 get_customer_data

    Provides basic information about a customer’s billing method and product ranges. This data is not confidential, so no customer password is required.

    Parameters
    Name Data type Description
    identification wsws_identification Identification object. Here, the WS customer ID is mandatory, but the WSWS password is optional.
    Return
    Name Level Description
    customer_data wsws_customer_data Customer data object.

    7.2 Order

    Messages of the type «confirm» contain important information and must be confirmed by the customer within a specified period (for example new General Terms and Conditions). If the deadline expires, the customer cannot place any further orders until the message is confirmed. The integrator must be capable of handling this functionality.

    7.2.1 new_order_preview

    Returns a new order as a free preview. 

    Parameters
    Name Data type Description
    identification wsws_identification Identification object.
    product int Number of the required product.
    single boolean default: FALSE
    • Determines whether the output is as a single file.
      TRUE: All postage paid impressions outputted to one file (single)
      It is mandatory to specify a medium.
      Only the file formats PDF and ZPL are supported.
      The data is returned on the order level.
      FALSE: The postage paid impressions are outputted in individual files (multiple)
      The data is returned on the stamp level.
    file_type token
    • The parameter defines the desired file format for outputting the postage paid impressions:
      - png
      - gif
      - bmp
      - pdf
      - zpl
    • [dpi]
    • int
    • Defines the resolution in dots per inch for the postage paid impressions. Values between 72 and 600 are permitted. If no resolution is specified, the labels will be generated with a resolution of 300 dpi.
    [print_zone] token Defines where the postal prepayment impression is used, thereby determining the correct display.
    1 Franking zone (as for stamp)
    2 Address zone (for recipient’s address)
    Specification allowed only for single=FALSE. If not specified, the appropriate print zone is selected automatically.
    [media] int ID of the required print medium.
    [quantity] int Number of postal prepayment impressions to be created. If an address is transmitted, this parameter is ignored.
    [a_addresses] array Array with one or more wsws_address objects.
    [sender] wsws_address A wsws_address object with the sender’s address.
    [media_startpos] int default: 1 The start_pos attribute can be set if the medium is a label format and defines the start label. Ignored for all other media.
    [image] base64 Base64 (RFC 2045) embedded image for the postal prepayment impression. The following formats are supported: GIF, PNG and JPG.
    • [document]
    • base64
    • Base64 (RFC 2045) embedded PDF file with an individual letter or mailshot. The file must have at least one recipient address in the window area of an envelope.
    • [printservice]
    • boolean
      Default: FALSE
    • Determines whether the output via the printing service is verified for the preview:
      TRUE Calculates the additional costs of the printing service, verifies the address of individual letters or mailshots. In contrast to new_order, the preview returns the documents to the customer for checking
      FALSE The data is outputted as before and is processed by the customer
    • [printservice_info]
    • wsws_address
    • The delivery address to which the WebStamp postage paid impressions created via the printing service are sent. May only be used in conjunction with printservice TRUE.
      Cannot be used for processing individual letters or mailshots.
    [post_product] boolean / default: FALSE This parameter defines which product number is specified.
    FALSE: WebStamp internal number
    TRUE: Swiss Post number (level number, mostly for Swiss Post’s internal applications).

    [reference]

    		 string The reference transmitted here refers to the order and is returned in the order result. It is used as the implementer’s own order reference. The value transmitted has no other function on the WebStamp site. It is transmitted only by the request to the response.
    [order_comment] string An order note can be included with the order. This also appears in the WebStamp GUI and in the journal.
    [license_number] string Number of the franking licence.
    [discount_code] string The discount code can be checked using the new_order_preview method. In the response, the prices are returned with the reduction taken into account.
    [return_code] string Sending of return note:
    registred Registered letters are returned as registered mail
    unregistred Registered letters are returned as unregistered mail.
    [ead_code] string Transfer of a code from the electronic customs declaration for international consignments containing goods from the EAD Mobile service. The sender and recipient addresses are transferred automatically.
    [cash_on_delivery_info] wsws_cash_on_delivery COD object with the relevant COD information.
    [custom_media] wsws_custom_media Custom print medium.
    Return
    Name Data type Description
    order wsws_order Order object.

    7.2.2 new_order

    new_order can be used to make an order in WebStamp. Returns a new order.

    Parameters
    Name Data type Description
    identification wsws_identification Identification object.
    product int Number of the required product.
    single boolean default: FALSE
    • Determines whether the output is as a single file.
      TRUE: All postage paid impressions outputted to one file (single)
      It is mandatory to specify a medium.
      Only the file formats PDF and ZPL are supported.
      The data is returned on the order level.
      FALSE: The postage paid impressions are outputted in individual files (multiple)
      The data is returned on the stamp level.
    file_type token
    • The parameter defines the desired file format for outputting the postage paid impressions:
      - png
      - gif
      - bmp
      - pdf
      - zpl
    • [dpi]
    • int
    • Defines the resolution in dots per inch for the postage paid impressions. Values between 72 and 600 are permitted. If no resolution is specified, the labels will be generated with a resolution of 300 dpi.
    [print_zone] int (1/2) Defines where the postal prepayment impression is used, thereby determining the correct display.
    1 Franking zone (as for stamp)
    2 Address zone (for recipient’s address)
    Specification allowed only for single=FALSE. If not specified, the appropriate print zone is selected automatically.
    [media] int ID of the required print medium.
    [quantity] int Number of postal prepayment impressions to be created. If an address is transmitted, this parameter is ignored.
    [a_addresses] array Array with the wsws_address object.
    [sender] wsws_address Address object with the sender’s address.
    [media_startpos] int default: 1 Position of the first label.
    [image] base64 Base64 (RFC 2045) embedded image for the postal prepayment impression. The following formats are supported: GIF, PNG and JPG.
    • [document]
    • base64
    • Base64 (RFC 2045) embedded PDF file with an individual letter or mailshot. The file must have at least one recipient address in the window area of an envelope.
    • [printservice]
    • boolean default: FALSE
    • Determines whether the output via the printing service is processed:
      TRUE The WebStamp postage paid impressions or individual letters/mailshots are forwarded to a print shop and delivered in printed form.
      FALSE The data is outputted as before and is processed by the customer
    • [printservice_info]
    • wsws_address
    • The delivery address to which the WebStamp postage paid impressions created via the printing service are sent. May only be used in conjunction with printservice TRUE.
      Cannot be used for processing individual letters or mailshots.
    [post_product] boolean / default: FALSE This parameter defines which product number is specified.
    FALSE: WebStamp internal number
    TRUE: Swiss Post number (level number, mostly for Swiss Post’s internal applications).

    [reference]

    		 string The reference transmitted here refers to the order and is returned in the order result. It is used as the implementer’s own order reference. The value transmitted has no other function on the WebStamp site. It is transmitted only by the request to the response.
    [order_comment] string An order note can be included with the order. This also appears in the WebStamp GUI and in the journal.
    [license_number] string Number of the franking licence.
    [discount_code] string Discount code to use for this order.
    [return_code] string Sending of return note:
    registred Registered letters are returned as registered mail
    unregistred Registered letters are returned as unregistered mail.
    [ead_code] string Transfer of a code from the electronic customs declaration for international consignments containing goods from the EAD Mobile service. The sender and recipient addresses are transferred automatically.
    [cash_on_delivery_info] wsws_cash_on_delivery COD object with the relevant COD information.
    [custom_media] wsws_custom_media Custom print medium.
    Return
    Name Data type Description
    order wsws_order Order object.

    7.2.3 copy_order_by_id

    • Creates a new order with identical settings from a previous order ID. The method cannot be used if the last order concerned an individual letter or mailshot.

     

    Parameters
    Name Data type Description
    identification wsws_identification Identification object.
    order_id int ID of a previous order.
    [reference] string The reference transmitted here refers to the order and is returned in the order result. It is used as the implementer’s own order reference. The value transmitted has no other function on the WebStamp site. It is transmitted only by the request to the response.
    [quantity] int The number of stamps to be created if different from the original order.
    [order_comment] string The order note if different from the original order.
    [file_type] token
    • This parameter defines the output format:
      - png
      - gif
      - bmp
      - pdf
      - zpl
    Return
    Name Data type Description
    order wsws_order Order object.

    7.2.4 previous_order

    Returns the data from a previous order for reprinting.

    Parameters
    Name Data type Description
    identification wsws_identification Identification object.
    order_id int ID of a previous order.
    stamp_id string ID of a postal prepayment impression from a previous order. Used to re-order an order (the entire order) in which this postal prepayment impression was used.
    Return
    Name Data type Description
    order wsws_order Order object.

    7.3 Info

    7.3.1 get_info_receipt

    Returns a single receipt for an order if an Order_ID was transmitted or a batch receipt for multiple orders if the start and end dates were transmitted.

    You can choose whether the information is returned as a PDF document or as XML.

    Name Version Data type Description
    [output] V6 token Specifies whether the output is returned as an XML response or as a PDF document.
    Possible values:
    - pdf (default)
    - xml
    [label_number] V6 int Creates a receipt for an order which contains the corresponding postal prepayment impression.
    Return
    Name Data type Description
    information wsws_receipt Returns the receipt for a transmitted order ID or a batch receipt for the period entered.

    7.3.2 get_info_delivery_receipt

    Return
    Name Data type Description
    information wsws_delivery_receipt  Returns the online delivery note for the order ID transmitted.

    7.3.3 get_info_journal

    Note

    This method is no longer available in later versions of the API because the same data can be obtained in more detail using
    the get_info_receipt method.

    Return
    Name Data type Description
    information wsws_journals ls Returns a container with the journals as specified in the filter criteria in the request.

    8 Error handling

    Errors are returned as SoapFaults. The “get_error_codes” method can be used to query all supported error codes.

    The error messages are as follows:

    8.1 System error messages

    Code Notification
    2000 de: Die XML-Anfrage ist fehlerhaft.
    fr: La requête XML est erronée.
    it: La richiesta XML è errata.
    en: The XML request contains errors.
    2003 de: Die Empfängeradresse ­dress_nr% ist nicht vollständig oder zu lang.
    fr: L’adresse du destinataire ­dress_nr% est incomplète ou trop longue.
    it: : Indirizzo del destinatario ­dress_nr% è incompleto o troppo lungo.
    en: The recipient address ­dress_nr% is incomplete or too long.
    2004 de: Es können nur %max_stamps% Frankiervermerke pro Bestellung generiert werden.
    fr: Seuls %max_stamps% timbres peuvent être générés par commande.
    it: : È possibile generare solo %max_stamps% segni di affrancatura per ogni ordine.
    en: A maximum of %max_stamps% postal prepayment impressions may be generated per order.
    2006 de: Das ausgewählte Produkt ist nicht mehr verfügbar und wurde ersetzt.
    fr: Le produit sélectionné n’est plus disponible et a été remplacé.
    it: Il prodotto selezionato non è più disponibile ed è stato sostituito.
    en: The selected product is no longer available and has been replaced.
    2007 de: Bitte wählen Sie ein Druckmedium.
    fr: Veuillez sélectionner un support d’impression.
    it: Scegliere un supporto di stampa.
    en: Please select a print medium.
    2008 de: Das ausgewählte Druckmedium ist nicht mehr verfügbar und wurde ersetzt.
    fr: Le support d’impression sélectionné n’est plus disponible et a été remplacé.
    it: : Il supporto di stampa selezionato non è più disponibile ed è stato sostituito.
    en: The print medium selected is no longer available and has been replaced.
    2009 de: Bitte geben Sie die Anzahl ein.
    fr: Veuillez indiquer la quantité.
    it: : Indicare la quantità.
    en: Please enter the quantity.
    2012 de: Die maximale Bildgrösse von %bytes% Bytes wurde überschritten.
    fr: La taille maximale de l’image (%bytes% octets) a été dépassée.
    it: Le dimensioni massime dell’immagine (%bytes% Bytes) sono state superate.
    en: The maximum image size of %bytes% bytes has been exceeded.
    2015 de: Das Druckmedium wird mit den gewählten Optionen nicht unterstützt. Wählen Sie ein anderes Druckmedium oder ändern Sie die Auswahl.
    fr: Le support d’impression n’est pas pris en charge avec les options sélectionnées. Veuillez choisir un support différent ou changer la sélection.
    it: Il supporto di stampa non è supportato con le opzioni selezionate. Scegliere un supporto diverso o modificare la selezione.
    en: The print medium is not supported with the selected options. Select another print medium or make a different selection.
    2016 de: Eine Adresse kann mit dem ausgewählten Produkt nicht verwendet werden.
    fr: Une adresse ne peut pas être utilisée avec le produit sélectionné.
    it: Un indirizzo non può essere utilizzato con il prodotto selezionato.
    en: An address cannot be used with the product selected.
    2017 de: Für das gewählte Produkt sind Empfängeradressen erforderlich. Bitte erfassen Sie Ihre Adressen.
    fr: Des adresses de destinataires sont requises pour le produit sélectionné. Veuillez saisir vos adresses.
    it: Per il prodotto selezionato sono necessari degli indirizzi di destinatari. Inserire i vostri indirizzi.
    en: Recipient addresses are required for the product selected. Please enter your addresses.
    2022 de: Für dieses Produkt ist eine Absenderadresse erforderlich.
    fr: Une adresse d’expéditeur est nécessaire pour ce produit.
    it: Per questo prodotto è necessario l’indirizzo del mittente.
    en: A sender’s address is required for this product.
    2025 de: Bestehende Bestellungen mit belegloser Nachnahme und ESR-Referenznummern können nicht als Grundlage für weitere Bestellungen
    verwendet werden. Bitte beginnen Sie eine neue Bestellung und erfassen Sie neue ESR-Referenznummern.
    fr: Des commandes existantes avec des remboursements sans titre et numéro référence BVR sans document ne peuvent pas être utilisées
    comme base pour d’autres commandes. Veuillez commencer une nouvelle commande et saisir un nouveau numéro de référence BVR.
    it: Gli ordini esistenti con rimborso senza giustificato e numero di riferimento PVR non possono essere utilizzati come base per ulteriori
    ordini. Iniziare un nuovo ordine e immettere un nuovo numero di riferimento PVR.
    en: Existing orders with electronic cash on delivery and ISR reference numbers cannot be used as a basis for further orders. Please start a
    new order and enter new ISR reference numbers.
    2029 de: Die Frankierlizenz im verwendeten Auftrag ist nicht mehr verfügbar.
    fr: La licence d’affranchissement correspondant à cet ordre n’est plus disponible.
    it: La licenza di affrancatura relativa a questo ordine non è più disponibile.
    en: The franking licence in the order used is no longer available.
    2200 de: Der Auftrag wurde nicht gefunden.
    fr: L’ordre n’a pas été trouvé.
    it: L’ordine non è stato trovato.
    en: The order has not been not found.
    2202 de: WS-Kunden-ID, Passwort oder Applikations-ID sind ungültig.
    fr: L’ID de client WS, le mot de passe ou l’ID de l’application ne sont pas valables.
    it: L’ID del cliente WS, la password e l’ID dell’applicazione non sono validi.
    en: WS customer ID, password or application ID are invalid.
    2208 de: Das Dateiformat ist unbekannt und kann nicht verwendet werden.
    fr: Le format de fichier est inconnu et ne peut pas être utilisé.
    it: Il formato del file è sconosciuto e non può essere usato.
    en: The file format is unknown and cannot be used.
    2210 de: Adressen können nicht in die Frankierzone gedruckt werden.
    fr: Les adresses ne peuvent pas être affranchies dans la zone d’affranchissement.
    it: Gli indirizzi non possono essere stampati nello spazio per l’affrancatura.
    en: Addresses cannot be printed in the franking area.
    2211 de: Die Verwendung von Bildern in der Adresszone ist nicht möglich.
    fr: L’utilisation d’images dans la zone d’adresse est impossible.
    it: Utilizzo di immagini non è possibile nello spazio per l’indirizzo.
    en: : The use of images in the address area is not supported.
    2212 de: Der Ausgabetyp «Single» ist nur für Bestellungen mit PDF zulässig.
    fr: Le type d’émission «Single» est autorisé seulement pour des commandes avec PDF.
    it: Il tipo di emissione «Single» è consentito solo per ordini con PDF.
    en: The “Single” issue type is only permitted for orders with PDF.
    2216 de: Die Transaktion ist fehlgeschlagen. Die Bestellung wurde nicht ausgeführt.
    Verwendung von Guthaben: Laden Sie Ihr Konto.
    Verwendung von Rechnung: Versuchen Sie es bitte später noch einmal. Bei weiteren Problemen melden Sie sich beim Kundendienst.
    fr: La transaction a échoué. La commande n’a pas été exécutée.
    Utilisation d’avoirs: veuillez charger votre compte.
    Utilisation de facture: veuillez essayer une nouvelle fois ultérieurement. Si les problèmes persistent, veuillez vous adresser au Service à la
    clientèle.
    it: La transazione non è riuscita. L’ordine non è stato eseguito.
    Utilizzo del credito: caricare il conto.
    Utilizzo della fattura: riprovare più tardi. In caso il problema persista, contattare il Servizio Clienti.
    en: The transaction has failed. The order was not executed.
    Use of credit balance: Top up your account.
    Use of invoice: Please try again later. If you encounter further problems, please contact Customer Service.
    2221 de: Das Feld «%field%» in der «­dress%» ist ungültig.
    fr: L’adresse de l’expéditeur n’est pas valable.
    it: L’indirizzo del mittente non è valido.
    en: : The “%field%” field in the “­dress%” is invalid.
    2223 de: Die Angabe eines Druckmediums ist im Ausgabetyp «Multiple» nicht möglich.
    fr: L’indication d’un support d’impression est impossible dans le type de sortie «Multiple».
    it: Nel tipo di emissione «Multiple» non è possibile indicare il supporto di stampa
    en: Entering a print medium is not possible for the “Multiple” issue type.
    2224 de: Das Produkt wurde nicht gefunden.
    fr: Le produit n’a pas été trouvé.
    it: Il prodotto non è stato trovato.
    en: The product was not found.
    2242 de: Ihre Angaben sind nicht bestätigt. Bitte führen Sie ein Login bei der Post durch (https://webstamp.post.ch/) und geben Sie die erhaltenen
    Verifikationscodes ein.
    fr: Vos données ne sont pas confirmées. Veuillez effectuer un login à la Poste (https://webstamp.post.ch/) et saisir le code de vérification que
    vous avez reçu.
    it: I vostri dati non sono confermati. Vi invitiamo a effettuare il login presso la Posta (https://webstamp.posta.ch/) e immettere i codici di verifica
    ricevuti.
    en: Your details are not confirmed. Please log in to Swiss Post (https://webstamp.post.ch/) and enter your verification code.
    2243 de: Der Zugriff auf WebStamp ist nur für Benutzer mit Wohnsitz Schweiz oder Liechtenstein möglich.
    fr: L’accès à WebStamp n’est possible qu’aux utilisateurs domiciliés en Suisse ou au Liechtenstein.
    it: L’accesso a WebStamp è possibile solo per gli utenti residenti in Svizzera o nel Principato del Liechtenstein.
    en: : Access to WebStamp is only possible for users resident in Switzerland or Liechtenstein.
    2244 de: Für diese Bestellung wurde kein Lieferschein generiert. Lieferscheine werden nur für Produkte generiert, die einen Lieferschein erfordern.
    fr: Aucun bulletin de livraison n’a été généré pour cette commande. Un bulletin de livraison n’est généré que pour les produits nécessitant un
    bulletin de livraison.
    it: Per questa ordinazione non è stato generato alcun bollettino di consegna. I bollettini di consegna vengono generati unicamente per i prodotti
    che lo richiedono.
    en: A delivery note has not been created for this order. Delivery notes are only generated for products that require a delivery note.
    2247 de: Der Lieferschein für dieses Produkt ist nicht mehr verfügbar. Kontaktieren Sie bitte den Kundendienst.
    fr: Le bulletin de livraison de ce produit n’est plus disponible. Veuillez prendre contact avec le Service à la clientèle.
    it: Il bollettino di consegna per questo prodotto non è più disponibile. Si prega di contattare il Servizio clienti.
    en: The delivery note for this product is no longer available. Please contact Customer Service.
    2248 de: Der maximale Nachnahmebetrag für %country% ist CHF %max_value% (Mindestbetrag CHF 0.05).
    fr: Le montant maximal du remboursement pour %country% est de %max_value% CHF (montant minimal 0.05 CHF).
    it: L’importo massimo del rimborso per %country% è di CHF %max_value% (importo minimo CHF 0.05).
    en: The maximum amount to be collected on delivery for %country% is CHF %max_value% (minimum amount: CHF 0.05).
    2249 de: Die ESR-Referenznummer «%esr%» ist ungültig.
    fr: Le numéro de référence «%esr%» n’est pas valable.
    it: Il numero di riferimento PVR «%esr%» non è valido.
    en: The ISR reference number “%esr%” is invalid.
    2250 de: Der Nachnahmebetrag ist nicht korrekt.
    Nachnahmebeträge müssen auf fünf Rappen genau erfasst werden. Verwenden Sie keine Sonderzeichen.
    Korrigieren Sie den eingegebenen Betrag.
    fr: Le montant du remboursement est incorrect.
    Les montants des remboursements doivent être enregistrés à cinq centimes près. N’utilisez pas de signes spéciaux.
    Veuillez corriger le montant indiqué.
    it: L’importo del rimborso non è corretto.
    Gli importi dei rimborsi devono essere arrotondati e registrati a cinque centesimi. Non utilizzare caratteri speciali.
    Correggere l’importo inserito.
    en: The amount to be collected on delivery is incorrect.
    COD charges must be rounded off to five centimes. Do not use special characters.
    Please correct the amount entered.
    2251 de: Die IBAN-Nummer fehlt oder die Angaben zum Endbegünstigten sind nicht vollständig (Endbegünstigter und PLZ/Ort).
    fr: Le numéro IBAN fait défaut ou les indications relatives au bénéficiaire final sont incomplètes (les coordonnées du bénéficiaire final,
    le NPA et la localité).
    it: Il numero IBAN manca o i dati relativi al beneficiario finale sono incompleti (beneficiario finale e NPA/località).
    en: The IBAN number is missing or the information for the end beneficiaries is incomplete (end beneficiary and postcode/location).
    2252 de: ESR-Teilnehmernummer fehlt oder ist ungültig.
    fr: Le numéro d’adhérent BVR fait défaut ou n’est pas valable.
    it: Il numero di aderente PVR manca o non è valido.
    en: : ISR participant number is missing or invalid.
    2253 de: Die IBAN-Nummer ist ungültig.
    fr: Le numéro IBAN n’est pas valable.
    it: Il numero IBAN non è valido.
    En: The IBAN number is invalid.
    2256 de: Der Nachnahmebetrag fehlt oder ist nicht möglich.
    fr: Montant du remboursement absent ou impossible.
    it: : L’mporto del rimborso manca o non è ammesso.
    en: The amount to be collected on delivery is missing or not possible.
    2257 de: Eine gültige Frankierlizenz ist erforderlich.
    fr: Une licence valable d’affranchissement est requise.
    it: È necessaria una licenza di affrancatura valida.
    en: A valid franking licence is required.
    2258 de: Die gewählte Frankierlizenz passt nicht zum Produkt.
    fr: La licence d’affranchissement sélectionnée ne correspond pas à ce produit.
    it: La licenza di affrancatura selezionata non è adatta al prodotto.
    en: The selected franking licence does not match the product.
    2261 de: Das Druckmedium „$type“ wird für benutzerdefinierte Medien mit den gewählten Optionen nicht unterstützt. Wählen Sie ein anderes
    Druckmedium oder ändern Sie die Auswahl.
    fr: : Le support d’impression «$type» n’est pas pris en charge pour les supports personnalisés avec les options sélectionnées. Veuillez choisir
    un support différent ou changer la sélection.
    it: Il supporto di stampa «$type» non è supportato per i supporti personalizzati con le opzioni selezionate. Scegliere un supporto diverso o
    modificare la selezione.
    en: The “$type” print medium is not supported for user-defined media with the options selected. Select another print medium or make a
    different selection.
    2262 de: Der Druckbereich des benutzerdefinierten Mediums ist zu klein.
    fr: La zone d’impression du support personnalisé est trop petite.
    it: : Lo spazio di stampa del supporto personalizzato è troppo piccolo.
    en: The print area for the user-defined medium is too small.
    2265 de: Die übergebene Orientierung ist ungültig.
    fr: L’orientation transmise n’est pas valable
    it: L’orientamento trasmesso non è valido.
    en: The specified orientation is invalid.
    2266 de: Der Ausgabetyp «multiple» ist für den Dateityp «$file_format» unzulässig.
    fr: Le type d’émission «multiple» n’est pas autorisé pour le type de fichier «$file_format».
    It: Il tipo di emissione «Multiple» non è consentito per il tipo di file «$file_format».
    en: The “Multiple” issue type is not permitted for the “$file_format” file type.
    2267 de: Für diese Applikation ist der Dateityp CSV nicht erlaubt.
    fr: Pour cette application, le type de fichier CSV n’est pas autorisé.
    it: Per questa applicazione, il tipo di file CSV non è consentito.
    en: The CSV file type is not permitted for this application.
    2268 de: Die allgemeinen Geschäftsbedingungen «Login Kundencenter» (AGB) haben sich geändert. Damit Sie die Onlinedienste weiterhin nutzen
    können bitten wir Sie diese auf www.swisspost.ch zu lesen und zu akzeptieren.
    fr: : Les conditions générales «Login Centre Clientèle» (CG) ont été modifiées. Veuillez les lire et les accepter sur www.poste.ch pour pouvoir
    continuer à profiter des services en ligne.
    it: Le Condizioni generali «Login Centro clienti» (CG) sono state modificate. Per poter continuare a usufruire dei servizi online, si prega di
    leggerle e accettarle su www.posta.ch.
    en: The “Customer Center Login” General Terms and Conditions (GTC) have changed. To continue using our online services, please read and
    accept these conditions at www.swisspost.ch.
    2271 de: Lieferscheine nach Bedarf können nicht über WSWS bezogen werden.
    fr: Les bulletins de livraison ne peuvent pas être retirés avec le WebService WebStamp.
    it: I bollettini di consegna secondo necessità non possono essere richiesti tramite il Webservice WebStamp.
    en: Delivery notes cannot be obtained as required via WSWS.
    2300 de: Allgemeiner technischer Fehler.
    fr: Erreur technique générale.
    it: Errore tecnico generale.
    en: General technical error.
    3100 de: Die eingelieferten Daten sind nicht signiert oder die Signatur wird nicht erkannt. Die Anfrage wird zurückgewiesen.
    fr: Les données fournies ne sont pas signées ou la signature n’est pas reconnue. La requête est rejetée.
    it: I dati forniti non sono firmati oppure la firma non è riconosciuta. La richiesta è respinta.
    en: The data provided is not signed or the signature is not recognized. The request will be rejected.
    5000 de: Der eingegebene Rabattcode ist ungültig
    fr: Le code de remise saisi n’est pas valable
    it: Il codice di sconto immesso non è valido
    en: The discount code entered is invalid
    5001 de: Der eingegebene Rabattcode ist abgelaufen
    fr: Le code de remise saisi a expiré
    it: Il codice di sconto immesso è scaduto
    en: The discount code entered has expired
    5002 de: Der eingegebene Rabattcode erfordert einen Mindestbetrag von %amount%
    fr: Le code de remise saisi requiert un montant minimal de %amount%
    it: Il codice di sconto immesso richiede un importo minimo di %amount%
    en: The discount code entered requires a minimum total of %amount%
    5003 de: Der eingegebene Rabattcode erfordert einen Mindestbestellmenge von %count% WebStamps
    fr: Le code de remise saisi requiert une commande minimale de %count% WebStamps
    it: Il codice di sconto immesso richiede una quantità di ordinazione minima di %count% WebStamp
    en: The discount code entered requires a minimum order quantity of %count% WebStamps
    5004 de: Der eingegebene Rabattcode erfordert einen Mindestbestellmenge von %count% WebStamps
    fr: Le code de remise saisi requiert une commande minimale de %count% WebStamps
    it: Il codice di sconto immesso richiede una quantità di ordinazione minima di %count% WebStamp
    en: The discount code entered requires a minimum order quantity of %count% WebStamps
    5005 de: Der eingegebene Rabattcode ist nur für WebStamp Druckservice anwendbar
    fr: Le code de remise saisi est valable uniquement pour les WebStamps imprimés qui ont été distribués
    it: Il codice di sconto immesso è applicabile solo a WebStamp recapitati allo stato stampato
    en: The discount code entered cannot be applied to printed WebStamp orders
    5006 de: Der eingegebene Rabattcode ist nur für selbst ausgedruckte WebStamps anwendbar
    fr: Le code de remise saisi est valable uniquement pour les WebStamps imprimés par l’utilisateur lui-même
    it: Il codice di sconto immesso è applicabile solo a WebStamp stampati autonomamente
    en: The discount code entered can only be applied to self-printed WebStamps
    5007 de: Der eingegebene Rabattcode wurde bereits eingelöst
    fr: Le code de remise saisi a déjà été utilisé
    it: Il codice di sconto immesso è già stato utilizzato
    en: The discount code entered has already been redeemed
    5008 de: Der eingegebene Rabattcode kann nicht mit einer BVE-Lizenz verwendet werden
    fr:Le code de remise saisi ne peut pas être utilisé avec une licence ELE
    it: Il codice di sconto immesso non può essere utilizzato con una licenza SLE
    en: The discount code entered cannot be used with a BVE license

    8.2 Example response

    In the SOAP Faults each of the described Errorcodes is returned. When support is requested, the code and Request-ID must always be given. Without this information, no technical clarifications are possible.

    <?xml version=“1.0“ encoding=“UTF-8“?><SOAP-ENV:Envelope xmlns:SOAP-ENV=“https://schemas.xmlsoap.org/soap/envelope/“xmlns:wsws=“https://webstamp.post.ch/wsws/soap/v5“> <SOAP-ENV:Body xmlns:wsws=“https://webstamp.post.ch/wsws/soap/v5“> <SOAP-ENV:Fault xmlns:wsws=“https://webstamp.post.ch/wsws/soap/v5“> <faultcode>Client</faultcode> <faultstring>Allgemeiner technischer Fehler</faultstring> <detail xmlns:wsws=“https://webstamp.post.ch/wsws/soap/v5“> <wsws:code>2300</wsws:code> <wsws:request_id>WD2C7BkZJUdpIBLvVbWp9wAAAAY</wsws:request_id> </detail> </SOAP-ENV:Fault> </SOAP-ENV:Body></SOAP-ENV:Envelope>

    9 Attachments

    9.1 WSDL

    The WSDL file can be downloaded at the following links:

    V5 <WebStamp Server>/wsws/soap/v5?wsdl

    V6 <WebStamp Server>/wsws/soap/v6?wsdl

    Please note

    If signing as described in section 2.7.3 is used, the endpoints in the WSDLs must be adapted.

    9.2 Example call

    Calling the method get_categories

    9.2.1 Request

    <soapenv:Envelope xmlns:soapenv="https://schemas.xmlsoap.org/soap/envelope/"xmlns:v6="https://webstamp.post.ch/wsws/soap/v6"> <soapenv:Header/> <soapenv:Body> <v6:get_categories> <args> <identification> <application>16bc33bea7216bc33bea7216bc33bea</application> <language>de</language> <userid>10000000</userid> <password>12345678</password> </identification> </args> </v6:get_categories> </soapenv:Body></soapenv:Envelope>

    9.2.2 Response

    <SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"xmlns:ns1="https://webstamp.post.ch/wsws/soap/v6"> <SOAP-ENV:Body> <ns1:get_categoriesResponse> <get_categoriesResult> <item> <name>Brief Inland</name> <number>1</number> <recipient_mandatory>false</recipient_mandatory> <valid_days>365</valid_days> </item> <item> <name>Brief Ausland</name> <number>2</number> <recipient_mandatory>false</recipient_mandatory> <valid_days>365</valid_days> </item> </get_categoriesResult> </ns1:get_categoriesResponse> </SOAP-ENV:Body></SOAP-ENV:Envelope>

    10 Information for integrators

    Useful information on connections can be found in the document: “Assistance for connection to WebStamp web service”.

    10.1 Integration Guidelines for EAD Orders

    Data transfer from electronic customs declarations (EAD)

    For postal consignments containing goods, the consignment and content information required for export are entered electronically and sent to the country of destination in advance. By transmitting the content details electronically, consignments containing goods can be processed and cleared through customs more quickly than before.

    The digital customs declaration (https://ead.webstamp.post.ch/mobile) enables customers to enter their own consignment data and receive an EAD code which references the data entered for the consignment contents, the weight of the consignment, the sender address and the recipient address.

    The EAD can now also be used in the WebStamp online service. To this end, the <ead_code> attribute is available as part of the new_order or new_order_preview methods. When using a valid EAD code, the integrator does not need a recipient address or sender address as this information is automatically transferred from the service for digital customs clearance.

    The following needs to be observed by integrators when using EAD codes:

    • A product needs to be transferred within the request, which matches the country code of the recipient address from the electronic customs declaration and also exceeds the declared consignment weight.
    • The attribute <media> in the request must contain a print medium which is compatible with EAD labels. Using the get_media_types method, an integrator can filter media types which feature the <ead_possible>true</ead_possible> attribute and then provide all suitable print media via get_medias.
    • For security reasons, data cannot be accessed via ead_code. The integrator also offers the customer the optional recording of an EAD code for integration purposes depending on the choice of product from zone 1 or zone 2, the format and weight, and any value-added services. If the customer enters an EAD code, the print media must be restricted accordingly.
    • Please note that for orders featuring ead_code and with a goods value of over CHF 400, additional customs documents in PDF file format and A4 page format are issued. Upon a successful new_order request, these documents are linked with the delivery note (delivery_receipt). We therefore ask you to ensure that the customer always prints both the label and delivery note in full and takes them to the acceptance point for posting in the event of an order featuring <ead_code>.
    • As usual, we recommend testing whether successful order processing is possible using a new_order_preview request.

    Footer