PDF Export

Structure

<subscription>
  <promotion-source> </promotion-source>
  <promotion-source-variant> </promotion-source-variant>
  <sales-promotion> </sales-promotion>
  <advertising-level> </advertising-level>
  <offer-code> </offer-code>
  <publication> </publication>
  <edition> </edition>
  <mix-type> </mix-type>
  <purchase-frequency> </purchase-frequency>
  <delivery-type> </delivery-type>
  <quantity> </quantity>
  <sales-organization> </sales-organization>
  <sales-suborganization> </sales-suborganization>
  <sales-bureau> </sales-bureau>
  <distribution-channel> </distribution-channel>
  <division> </division>
  <customer-purchase-order-number> </customer-purchase-order-number>
  <customer-purchase-order-type> </customer-purchase-order-type>
  <customer-purchase-order-date> </customer-purchase-order-date>
  <valid-from> </valid-from>
  <valid-to> </valid-to>
  <issue-number-from> </issue-number-from>
  <issue-number-to> </issue-number-to>
  <archive-reference></archive-reference>
  <payment-method> </payment-method>
  <payment-method-details>
    <!-- entweder 'payment-method-cheque' -->
    <payment-method-cheque>
      <cheque-bank-clearing-account></cheque-bank-clearing-account>
      <cheque-number></cheque-number>
      <cheque-amount></cheque-amount>
      <cheque-currency-code></cheque-currency-code>
      <cheque-bank-code></cheque-bank-code>
      <cheque-bank-control-key></cheque-bank-control-key>
      <cheque-bank-country-code></cheque-bank-country-code>
      <cheque-bank-account-number></cheque-bank-account-number>
      <cheque-holder></cheque-holder>
    </payment-method-cheque>
    <!-- oder 'payment-method-other' -->
    <payment-method-other>
      <other-bank-clearing-account></other-bank-clearing-account>
      <other-amount></other-amount>
      <other-currency-code></other-currency-code>
      <other-payee-note></other-payee-note>
    </payment-method-other>
  </payment-method-details>
  <total-paid-currency-code></total-paid-currency-code>
  <total-paid-amount></total-paid-amount>
  <wallet-part-payment-amount></wallet-part-payment-amount>
  <extra-pay-discount>
    <currency-code></currency-code>
    <discount></discount>
  </extra-pay-discount>
  <extra-pay-voucher>     
    <bank-clearing-account></bank-clearing-account>
    <amount></amount>
    <currency-code></currency-code>
    <payee-note></payee-note>
  </extra-pay-voucher>
  <print-invoice> </print-invoice>
  <purchase-reason> </purchase-reason>
  <delivery-end-reason> </delivery-end-reason>
  <billing-from> </billing-from>
  <issue-billing-from> </issue-billing-from>
  <currency-code></currency-code>
  <price-list-type> </price-list-type>
  <fixed-price-list-and-currency-code>Y</fixed-price-list-and-currency-code>
  <debit-account>
    <debit-account-id></debit-account-id>
    <debit-bank-code> </debit-bank-code>
    <debit-country-code> </debit-country-code>
    <debit-account-number> </debit-account-number>
    <debit-account-holder> </debit-account-holder>
    <debit-continuous> </debit-continuous>
    <debit-due-date> </debit-due-date>
    <iban></iban>
    <bic></bic>
  </debit-account>
  <cc-account>
    <cc-account-id></cc-account-id>
    <cc-company-code> </cc-company-code>
    <cc-number> </cc-number>
    <cc-expiry> </cc-expiry>
  </cc-account>
  <sepa-mandate>
    <creation-type></creation-type>
    <transaction-type></transaction-type>
    <details>
      <b2b-mandate></b2b-mandate>
      <mandate-ref-pre-creditor></mandate-ref-pre-creditor>
      <previous-creditor-id></previous-creditor-id>
      <previous-bic></previous-bic>
      <last-due-date></last-due-date>
    </details>
  </sepa-mandate>
  <price-key-in-trialterm> </price-key-in-trialterm>
  <billing-frequency-in-trialterm> </billing-frequency-in-trialterm>
  <price-group-in-trialterm> </price-group-in-trialterm>
  <duration-in-trialterm></duration-in-trialterm>
  <unit-in-trialterm></unit-in-trialterm>
  <price-key-in-normalterm1> </price-key-in-normalterm1>
  <billing-frequency-in-normalterm1> </billing-frequency-in-normalterm1>
  <price-group-in-normalterm1> </price-group-in-normalterm1>
  <duration-in-normalterm1></duration-in-normalterm1>
  <unit-in-normalterm1></unit-in-normalterm1>
  <price-key> </price-key>
  <billing-frequency> </billing-frequency>
  <price-group> </price-group>
  <duration> </duration>
  <unit> </unit>
  <postage-key> </postage-key>
  <dsb-media1> </dsb-media1>
  <dsb-media2> </dsb-media2>
  <dsb-media3> </dsb-media3>
  <dsb-media4> </dsb-media4>
  <dsb-media2b> </dsb-media2b>
  <dsb-media7> </dsb-media7>
  <rule-id> </rule-id>
  <external-order-number></external-order-number>
  <input-office> </input-office>
  <input-date> </input-date>
  <input-user> </input-user>
  <stack-name></stack-name>
  <save-in-system> </save-in-system>
  <post-at-once> </post-at-once>
  <skip-doi-process>false</skip-doi-process>
  <adjust-upper-and-lower-case> </adjust-upper-and-lower-case>
  <order-rating></order-rating>
  <stack-lock-code></stack-lock-code>
  <agent-number> </agent-number>
  <agent-organisation> </agent-organisation>
  <cost-center> </cost-center>
  <matriculated> </matriculated>
  <matriculated-to> </matriculated-to>
  <advance-billing>false</advance-billing>
  <previously-billed-to> </previously-billed-to>
  <issue-previously-billed-to> </issue-previously-billed-to>
  <delivery-start-statistical> </delivery-start-statistical>
  <issue-delivery-start-statistical> </issue-delivery-start-statistical>
  <dispatch-type> </dispatch-type>
  <dispatch-text> </dispatch-text>
  <ivw-group> </ivw-group>
  <statistic-group> </statistic-group>
  <dsb-trx-id-for-ctp> </dsb-trx-id-for-ctp>
  <dsb-trx-id-for-epayment> </dsb-trx-id-for-epayment>
  <dsb-trx-id-for-solvency-check> </dsb-trx-id-for-solvency-check>
  <!—- one for each business partner -->
  <subscription-to-business-partner-relation>
    ...
  </subscription-to-business-partner-relation>
  <renewal>
    <renewal-order-number></renewal-order-number>
    <automatic-renewal></automatic-renewal>
  </renewal>
  <!—- one up to 3 -->
  <business-partner id=””>
    ...
  </business-partner>
  <!—- 0 to n possible -->
  <premium>
    ...
  </premium>
  <premium-payment>
    <premium-payment-method></premium-payment-method>
    <!-- either -->
    <debit-account>
      . . .
    </debit-account>
    <!-- or -->
    <cc-account>
      . . .
    </cc-account>
  </premium-payment>
  <!—- 0 to n possible -->
  <order-attribute>
    ...
  </order-attribute>
  <core-wbz-conditions>
    <wbz-wkz> </wbz-wkz>
    <wbz-wkz-fix> </wbz-wkz-fix>
    <wbz-condition> </wbz-condition>
  </core-wbz-conditions>
</subscription>

Element Definitions

Field NameLengthTypeTextm = Must k = can (m) = conditional MustRemark, field supply or encoding
promotion-source10CSource code (in AVS/3)m.
promotion-source-variant1CPromotion-source-variant(m)
reference-doc20CReferenzbeleg-Contains the order number of the legacy system. Otherwise it is identical with the field order-number.
Caution! This field DOESN'T exist in the WSI Interface!!
But there is an alternative solution:
Setting the old subscription number as an order attrinute. DSB can set this by a program in the field “reference number”.
Example:
<order-attribute>
<type>ABOALT</type>
<value>4241407</value>
</order-attribute>
sales-promotion8CSales-promotion(m)In case if several sales-promotions have been set up for a BQ so it must be told which one can be used
advertising-level2NAdvertising levelkAdvertising level of the accepted
offer(0-99 )
offer-code5C(renewal-)offer code(m)
publication8Cpublication(m)when blank, then automatic determination out of BQ
edition8NCedition(m)when blank, then automatic determination out of publication
mix-type2Cmix-type(m)Value is dependent on client Values can be
01 = full sub,
10 = with CD,
11 = with DVD
Please discuss this with customer service. If blank, then automatic investigation out of BQ.
purchase-frequency2CPurchase-frequency(m)Must only be indicated if it is not clear for the client. Possible values are:
VA = full sub
Other values are client specific.
delivery-type2CDelivery-typekDepending on client. Please contact your AVS/3-customer service for possible values.
quantity6NQuantity of customer order-publisher-Position-division(m)If not stated, amount 1 is accepted
sales-organization4CSales-organization(m)Must not be filled, if it can be detected over the BQ or it is clear in PVA (Field ‚edition‘).
sales-suborganisation5CUnder-Organization of vkorgk
sales-bureau4CSales-bureau(m)Investigation based on the field „input-user“. otherwise: 0001
Other values are client specific.
distribution-channel2CDistribution-channel(m)Must only be stated, if the value can not be clearly derivated out of the publication (field ‚publication‘).
division2Cdivision(m)Must only be stated, if the value can not be clearly derivated out of the publication (field ‚publication‘).
customer-purchase-order-number20CCustomer-purchase-order no.k
customer-purchase-order-type4COrder type of customerke.g. ‚I‘ → Internet; ‚T‘ → by telephone
customer-purchase-order-date10DCustomer purchase order date YYYY-MM-DDk
valid-from10DDate from next delivery of issuekIn case that the date has no shipping date, it is projected for the next dispatch
This field and “issue-number-from” are mutal exclusive.
valid-to10DDate to delivery of issues should be executedkIf the date is no shipping date it is counted downward to the latest dispatch
This field and “issue-number-to are mutal exclusive.
issue-number-from9CIssue-number of first delivered issue. Default Format: HHHH/YYYY or any other client specific format /free text.kDefault: next copy in dispatch.
This field and “valid-from” are mutal exclusive.
issue-number-to9CIssue-number of last delivered issue. Default Format: HHHH/YYYY or any other client specific format /free text.kDefault: unlimited respectively the registered period in BQ.
This field and “valid-to” are mutal exclusive.
archive-reference20CReference Numberk
payment-method1CPayment-methodmE → Payment per bank collection(national)
D → Payment per bank
collection(SEPA DirectDebit)1)
K → Payment per credit card
R → payment per invoice.
P → payment per Paypal
For foreign customers are possibly further ways of payment provided.
payment-method-details
* payment-method-cheque
* cheque-bank-clearing-account10CBank clearing account(m)Must, if structure 'payment-method-cheque' is under 'payment-method-details' denoted
* cheque-number13CCheque number(m)Must, if structure 'payment-method-cheque' is under 'payment-method-details' denoted
* cheque-amount9,2NAmount in transaction currency(m)Must, if structure 'payment-method-cheque' is under 'payment-method-details' denoted
* cheque-currency-code3CISO Currency code(m)Must, if structure 'payment-method-cheque' is under 'payment-method-details' denoted
Currency as ISO-Code
EUR Euro
CHF Schweizer Franken
GBP Great British Pound
etc.
* cheque-bank-code15CBank code(k)Can, if structure 'payment-method-cheque' is under 'payment-method-details' denoted
* cheque-bank-control-key2CBank control key(k)Can, if structure 'payment-method-cheque' is under 'payment-method-details' denotedt
* cheque-bank-country-code3CBank country code(k)Can, if structure 'payment-method-cheque' is under 'payment-method-details' denoted
* cheque-bank-account-number18CBank account number(k)Can, if structure 'payment-method-cheque' is under 'payment-method-details' denoted
* cheque-holder60CHolder name(k)Can, if structure 'payment-method-cheque' is under 'payment-method-details' denoted
* payment-method-other
* other-bank-clearing-account10CBank clearing account(m)Must, if structure 'payment-method-cother' is under 'payment-method-details' denoted
* other-amount9,2NAmount in transaction currency(m)Must, if structure 'payment-method-cother' is under 'payment-method-details' denoted
* other-currency-code3CCurrency code(m)Must, if structure 'payment-method-cother' is under 'payment-method-details' denoted
Currency as ISO-Code
EUR Euro
CHF Schweizer Franken
GBP Great British Pound
etc.
* other-payee-note80CPayee note(k)Can, if structure 'payment-method-cother' is under 'payment-method-details' denoted
total-paid-currency-code3CCurrency codekonly in use for renewal
total-paid-amount9,2NDkonly in use for renewal
wallet-part-payment-amount9,2Namount paid by voucherkonly in use for renewal
extra-pay-discount
* currency-code3CCurrency code for discount/extra-pay(m)only in use for renewal
* discount9,2Ndiscount(m)
* extra-pay9,2Nextra pay(m)not yet implemented
extra-pay-voucher BETA
* bank-clearing-account10CBank clearing account(m)BETA Must, if structure 'extra-pay-voucher' denoted
* amount9,2NAmount in transaction currency(m)BETA Must, if structure 'extra-pay-voucher' denoted
* currency-code3CCurrency code(m)BETA Must, if structure 'extra-pay-voucher' denoted
Currency as ISO-Code
EUR Euro
CHF Schweizer Franken
GBP Great British Pound
etc.
* payee-note80CPayee note(k)BETA Can, if structure 'extra-pay-voucher' denoted
print-invoice1CMark print invoicekY = print invoices
N = print no invoices
purchase-reason3CPurchase reasonk
delivery-end-reason3CDelivery end reasonkDepending on client. Setting up after consultation with your AVS/3-customer service.
billing-from10DBilling-fromkDate, from when it should be billed
issue-billing-from9CIssue-billing-fromkCopy no., from which it should be billed
currency-code3CCurrencykCurrency as ISO-Code
EUR Euro
CHF Schweizer Franken
GBP Great British Pound
etc.
price-list-type2CPrice-list-type(m)when blank, investigation logic out: /DSB/JOT_PL_FIND
fixed-price-list-and-currency-code1C Y/N k don't change the submitted price and currency code (Default: N)
debit-account
* debit-account-id4Cdebit account idk
* debit-bank-code15CDebit-bank-code(m)Must be, when corresponding way of payment
* debit-country-code3CISO-country code of bankkISO-country codes of bank data when corresponding way of payment.
* debit-account-number18CDebit account number(m)Must be, when corresponding way of payment.
* debit-account-holder60CName of account holder(m)Must be, when corresponding was of payment.
* debit-continuous1CIs there a direct debit mandate?(m)Y = yes
N = no
* debit-due-date2Cdue day for direct-debit(m)Day of month (0-31)
* iban34CInternational bank account nummer(m)
* bic11CBank identifier codek
cc-account only if credit card payment is not done by payment provider
* cc-account-id6CReference to existing creditcard data in the systemk
* cc-company-code4Ccc-type(m)credit card company
* cc-number25Ccc-no.(m)credtir card number
* cc-expiry6Dcc-expiry(m)expiry month Format YYYYMM
sepa-mandate
* creation-type1C (m)„ “ = no mandate created
„N“ = Create new mandate
„T“ l= Mandate change(currently not to use)
„M“ = Mandate migration(currently not to use)
* transaction-type1C k„1“ = 1x Mandate
„N“ = Multiple Mandate (default)
* details
* b2b-mandate1C B2B-Mandate
“Y” oder “N” (currently not supported)
* mandate-ref-per-creditor35C Unique reference to mandate per creditor / previous mandate id
(only in conjunction with <creation-type> „T“ und „M“)
* previous-creditor-id35C Creditor identifier(unique accross country) / previous creditor id
(only in conjunction with <creation-type> „T“ und „M“)
* previous-bic11C Previous BIC-Code
((only in conjunction with <creation-type> „T“ und „M“)
* last-due-date10C
price-key-in-trialterm4CPrice-key-in-trialtermkNomination. The attributes depend on the client. A nomination you receive from your AVS/3-customer service.
billing-frequency-in-trialterm2CBilling-frequency-in-trialtermkbilling frequency
price-group-in-trialterm2CPrice-group-in-trialtermkPrice-group of trialterm
duration-in-trialterm3CDuration-in-trialtermkDuration of position
unit-in-trialterm3CUnit-in-trialtermkFor example.:
MON months
WCH weeks
TAG days
price-key-in-normalterm14CPrice-key-in-normalterm 1kNomination. The attributes depend on the client. A nomination you receive from your AVS/3- customer service.
billing-frequency-in-normalterm12CBilling-frequency-in-normalterm 1kbilling frequency
price-group-in-normalterm12CPrice-group-in-normalterm1k
duration-in-normalterm13CDuration-in-normalterm1kDuration of position
unit-in-normalterm13CUnit-in-normalterm 1kFor example:
MON months
WCH weeks
TAG days
price-key4CPrice-key of normaltermkNomination. The attributes depend on the client. A nomination you receive from your AVS/3-customer service.
billing-frequency2CBilling frequency of normaltermkbilling frequency
price-group2CPrice-group of normaltermk
duration3CDuration of normaltermkDuration of position
unit3CUnit of duration of normaltermkFor example:
MON months
WCH weeks
TAG days
postage-key2CPostage-key (dispatch costs investigation)kIf a postage-key is available, it is transferred “fix” into the backend system, without any customization changes configured in the AVS/3 system.
If you want to use the optimization from the backend, the postage-key can be easily transferred empty.
dsb-media11C kField for free disposal. Is stored to the order.
dsb-media22C kField for free disposal. Is stored to the order.
dsb-media33C kField for free disposal. Is stored to the order.
dsb-media44C kField for free disposal. Is stored to the order.
dsb-media2b2C kField for free disposal. Is stored to the order.
dsb-media77C kField for free disposal. Is stored to the order.
rule-id 3 C k Unique Identifikationnumber of a matching rule for order evaluation
external-order-number35CExternal-order-number(m)This field is a required element in ‚createOrderBufferd‘ and prevents duplicate recordings in the OAA
In this field a unique external order no. is expected. This value is NOT stored in AVS/3 and cannot be used as a external reference Please use a order-attribute for this purpose instead.
input-office12CInput-officem
input-date10DInput-datemFormat YYYY-MM-DD
input-user12CInput-userm
stack-name17CStack-namek
save-in-system1C m‚Y‘ the committed data is stored. (Default)
‚N‘ It is just a test of data without saving.
post-at-once1C m‚Y‘ the committed data is registered immediately.
‚N‘ the committed data is first registered through a consultant.
skip-doi-process B Should the double opt in process be skipped? Default is false. Only relevant with client that use the doi process.
adjust-upper-and-lower-case1C k‚Y‘ Address data is changed from only capital letters or only small letters into capital and small letters. (Default)
‚N‘ Spelling of the address remains.
order-rating1C k‚Y‘ order rating is active (Default)
‚N‘ order rating is deactivated/inactive
stack-lock-code1CStack lock codekW= webservice
F=file
agent-number10CExternal agent-numberk
agent-organisation5Cexternal agent-organisationk
cost-center10CCost-centerkto debited cost-center
matriculated1CMark present matriculated billk‚Y‘ → matriculation certification available
‚N‘ → no matriculation certification available
If “Y”, the next field must be supplied too.
matriculated-to10DMatriculated-tok
advance-billing BBilling in advance flag (default: false)
previously-billed-to10DPreviously-billed-tokDate „billed to “ in pre-system
issue-previously-billed-to9CIssue-previously-billed-tokCopy no. “billed to” in pre-system
delivery-start-statistical10DDelivery-start-statisticalkDate for statistical delivery start
issue-delivery-start-statistical9CIssue-delivery-start-statisticalkCopy no. for statistical delivery start
dispatch-type2CDispatch-typekLP = air-mail
dispatch-text5CDispatch-textkFurther criteria in dispatch-text
ivw-group2CSpecial group for ivw evaluationk
statistic-group2CToken of statistic-groupk
ct-commitment-period2NCommitment-periodkTerms of contract:
Duration of commitment-period (regular cancellation after x
Months possible)
ct-cancellation-period2NCancellation-periodkTerms of contract:
period of notice
ct-renewal2NCt-renewalkTerms of contract:
(autom.) renewal of bounded time limit
dsb-trx-id-for-ctp36CCreditcard authorization GUIDkCreditcard-Authorisation-GUID in the dsb-Webservice environment.
Contains the “cc-dsb-transaction-id” from a previous made Notify request (for example notifyCardTransactionWithWirecard)
dsb-trx-id-for-epayment36CE-Payment GUIDkE-Payment-GUID in the dsb-WSI
Contains the “dsb-transaction-id” from a previous made EPayment Notify request(for example notifyTrxWirecard)
dsb-trx-id-for-solvency-check36CSolvency check GUIDkSolvency-Check-GUID in the dsb-WSI (at the moment without function in the AVS/3)
subscription-to-business-partner-relation see description chapter below
renewal
* renewal-order-number10C krenewal order-number
* automatic-renewal1C kautomatic renewal 'Y' / 'N'
business-partner See description below
premium See description below
premium-payment See description below
order-attribute See description below
core-wbz-conditions
* wbz-wkz1Cpromotion charge benefitk
* wbz-wkz-fix1CWKZ-Key fixationk‚Y‘ = WKZ-Key fixed(x), ‚N‘ not fixed
* wbz-condition3CWBZ-ConditionkAbotype in data exchange



1)
SEPA Direct Debit requires a SEPA mandate in conjunction with a bank account and IBAN
This website uses cookies for visitor traffic analysis. By using the website, you agree with storing the cookies on your computer.More information