getBpData

This Method delivers all data of the business partner.

Object: /net/dsb/vhs3/Bp
Method: getBpData
Version: 1.0.0

Parameter

Name	Type / Lenght	Opt. / Mandat	Description
bp-number	N / 10	m	Business Partner Number.

Response Element

XML fragment business-partner

Example Request

<?xml version="1.0" encoding="UTF-8"?>
<message version="1.0" system="vhs/3" >
  <header>
    <client>4711</client>
    <service-provider>999</service-provider>
  </header>
  <body>
    <bp-number>12345</bp-number>
  </body>
</message>

Example Response

<?xml version="1.0" encoding="UTF-8"?>
<message version="1.0" system="vhs/3">
  <header>
    <client>4711</client>
    <service-provider>999</service-provider>
  </header>
  <body>
    <business-partner>
    </business-partner>
  </body>
</message>

Response Structure

Structure <business-partner>

<business-partner>
  <bp-number></bp-number>
  <category></category>
  <address-state></address-state>
  <address-source></address-source>
  <last-name1></last-name1>
  <last-name2></last-name2>
  <first-name></first-name>
  <titel></titel>
  <sex></sex>
  <date-of-birth></date-of-birth>
  <company1></company1>
  <company2></company2>
  <company3></company3>
  <eu-sales-tax-number></eu-sales-tax-number>
  <salutation-code></salutation-code>
  <country-code></country-code>
  <street></street>
  <street-suffix></street-suffix>
  <street-number></street-number>
  <street-number-suffix></street-number-suffix>
  <zipcode></zipcode>
  <city></city>
  <district></district>
  <region-code></region-code>
  <po-box></po-box>
  <po-box-zipcode></po-box-zipcode>
  <po-box-city></po-box-city>
  <!—-0 to n -->
  <communication type=""> </communication>
  <block-tag></block-tag>
  <bp-extra-pay-discount-code></bp-extra-pay-discount-code>
  <solvency-state></solvency-state>
  <solvency-code></solvency-code>
  <solvency-action></solvency-action>
  <solvency-service-provider></solvency-service-provider>
  <date-of-solvency-check></date-of-solvency-check>
  <!—-0 to n -->
  <blocked-product-group></blocked-product-group>
</business-partner>

Element Definitions

Field	Length	Type	Remark, field supply or encoding
bp-number	10	N	Customer number
category	1	AN	Address type (Look at Code tables)
address-state	2	AN	Status (Look at Code tables)
address-source	10	AN	Address source\\ Content is declared by the department.
last-name1	30	AN	Last name1
last-name2	30	AN	Last name2
first-name	30	AN	First-name
titel	30	AN	Title
sex	1	AN	Gender M = male F = female <other> = unknown
date-of-birth	8	N	Date of birth Format YYYYMMDD
company1	30	AN	Company line 1
company2	30	AN	Company line 2
company3	30	AN	Company line 3
eu-sales-tax-number	14	AN	EU sales-tax-number
salutation-code	2	AN	Salutation code (see code tables)
country-code	3	AN	car - country code as international car code
street	50	AN	Street
street-suffix	50	AN	Street suffix
street-number	10	AN	Street number
street-number-suffix	15	AN	Street number Suffix
zipcode	11	AN	Zip Code
city	50	AN	City
district	40 (50)	AN	district
region-code	3	AN	region-code (Coded field; content is declared by the department)
po-box	10	AN	P. O. Box
po-box-zipcode	11	AN	P. O. Box zip code
po-box-city	50	AN	P. O. Box City
block-tag	1	AN	Block Tag X = Customer is blocked
solvency-state	1	AN	Solvency state (Look at Code tables)
solvency-code	4	AN	Solvecny code (Look at Code tables)
solvency-action	5	AN	recommended action
solvecny-service-provider	2	AN	01 = Infoscore 02 = 4Control
date-of-solvency-check	8	N	Date of the solvency-check. Format YYYYMMDD
blocked-product-group	4	AN	Blocked product-group
communication type	2	AN	Communication-Type (Values)
communication	50	AN	Communication-Number

Field mapping to VIS

XML-Element	Table and Field in VIS
bp-number	I_ADR.EXT_NR
category	I_ADR.SA_ART
address-state	I_ADR.SA_STATUS
address-source	I_ADR.SA_AQ
last-name1	I_ADR.AA_PER_NAME1
last-name2	I_ADR.AA_PER_NAME2
first-name	I_ADR.AA_PER_VORNAME
titel	I_ADR.AA_PER_TITEL
sex	I_ADR.AN_GESCHLECHT
date-of-birth	I_ADR.AN_GEBURTSTAG
company1	I_ADR.AA_NAME1
company2	I_ADR.AA_NAME2
company3	I_ADR.AA_NAME3
eu-sales-tax-number	I_ADR.AJ_UST_ID
salutation-code	I_ADR.AA_ANREDE
country-code	I_ADR.AA_LAND
street	I_ADR.AA_STR
street-suffix	I_ADR_AA_STR_ZUS
street-number	I_ADR.AA_HAUS_NR
street-number-suffix	I_ADR.AA_HAUS_NR_ZUS
zipcode	I_ADR.AA_STR_PLZ
city	I_ADR.AA_ORT
district	I_ADR.AA_ORT_ZUS
region-code	I_ADR.AA_PROVINZ
po-box	I_ADR.AA_PF_NR
po-box-zipcode	I_ADR.AA_PF_PLZ
po-box-city	I_ADR.AA_PF_ORT
block-tag	V_KUNDEN.KDE_SPERR
solvency-state	V_KUNDEN.KDE_BONI_KENN
product-group	V_KUNDEN_PRODGRP.KDE_PRODUKTGRUPPE
communication type	I_KOMMUNIKATION.KOMM_ART
communication	I_KOMMUNIKATION.KOMM_NR