Body

xml PARDAT (Party Data)

The Party Data message is meant for sharing party/entity information over the Btwentyfour Platform. Connected parties can use the message to add new stores, marketplace websites or local sales offices/subsidiaries, and to update e.g. geograpic location or contact details for existing already registered party records. 

General usage

- The message includes functionality

Name Required Description Examples Xpath Type Limits Sort Id
Btwentyfour message ID

Unique partyData message reference (automatically issued by Btwentyfour Open Commerce Platform. upon import/export of file)

 <b24Message messageId="716a2875-409c-4995-8cad-ced808f972f2" messageDate="2022-04-21T12:57:39.747Z" xmlns="http://btwentyfour.com/schemas/commerce/2.1"> 
Text 1000 1
Btwentyfour message date

Unique partyData message date (automatically issued by Btwentyfour Open Commerce Platform. upon import/export of file)

 <b24Message messageId="716a2875-409c-4995-8cad-ced808f972f2" messageDate="2022-04-21T12:57:39.747Z" xmlns="http://btwentyfour.com/schemas/commerce/2.1"> 
Date/Time 2000 2
Sender Yes

The sender of the partyData message, identified by a GLN.

 <sender gln="7340117836950"> 
/b24Message/partyData/sender/@gln Number 3000 3
Recipient Yes

The recipient of the partyData message, identified by a GLN.

 <recipient gln="7340117815580"> 
/b24Message/partyData/recipient/@gln Number 4000 4
Party Data Number

Unique document reference for the specific partyData message.

 <documentReference documentType="PartyData" id="11221" date="2022-06-30" /> 
/b24Message/partyData/documentReference[@documentType="PartyData"]/@id Text 5000 5
Party Data Date

Issue date of the specific partyData message

 <documentReference documentType="PartyData" id="11221" date="2021-06-30" /> 
/b24Message/partyData/documentReference[@documentType="PartyData"]/@date Date/Time 6000 6
Party GLN Yes

Unique GLN of the specific party record.

 <party gln="9999219643744" name="Buyer Concept Sweden" orgNo="11111111-1000" vatNo="SE111111111000" isActive="true" parentGln="0000000000500" parentName="Bu500"> 
/b24Message/partyData/party/@gln Number 7000 7
Party Name Yes

Company/Display name of the specific party record.

 <party gln="9999219643744" name="Buyer Concept Sweden" orgNo="11111111-1000" vatNo="SE111111111000" isActive="true" parentGln="0000000000500" parentName="Bu500"> 
/b24Message/partyData/party/@name Text 8000 8
Party Organization Number

Organization Number of the specific party record.

 <party gln="9999219643744" name="Buyer Concept Sweden" orgNo="11111111-1000" vatNo="SE111111111000" isActive="true" parentGln="0000000000500" parentName="Bu500"> 
/b24Message/partyData/party/@orgNo Text 9000 9
Party VAT number

VAT Number of the specific party record.

 <party gln="9999219643744" name="Buyer Concept Sweden" orgNo="11111111-1000" vatNo="SE111111111000" isActive="true" parentGln="0000000000500" parentName="Bu500"> 
/b24Message/partyData/party/@vatNo Text 10000 10
IsActive

Indication of whether the specified party record is currently active/used or not (true/false). Records sent with "false" will be hidden/inactivated in Btwentyfour Portal UI.

  <party gln="9999219643744" name="Buyer Concept Sweden" orgNo="11111111-1000" vatNo="SE111111111000" isActive="true" parentGln="0000000000500" parentName="Bu500"> 
/b24Message/partyData/party/@isActive Yes/No 11000 11
Parent GLN Yes

GLN of the the specified party's parent identity in the Btwentyfour Platform. Please note that used parent GLN must already exist in the Btwentyfour Platform. New business identities/parent GLNs must be established via Btwentyfour Sales Dept.

  <party gln="9999219643744" name="Buyer Concept Sweden" orgNo="11111111-1000" vatNo="SE111111111000" isActive="true" parentGln="0000000000500" parentName="Bu500"> 
/b24Message/partyData/party/@parentGln Number 12000 12
Parent Name

Name of the specified party's parent identity in the Btwentyfour Platform. Please note that used parent GLN must already exist in the Btwentyfour Platform. New business identities/parent GLNs must be established via Btwentyfour Sales Dept.

  <party gln="9999219643744" name="Buyer Concept Sweden" orgNo="11111111-1000" vatNo="SE111111111000" isActive="true" parentGln="0000000000500" parentName="Bu500"> 
/b24Message/partyData/party/@parentName 13000 13
Party Latitude

Latitude of the specific party record.

 <latitude>57.4963576</latitude> 
/b24Message/partyData/party/location/latitude Number 23000 23
Party Longitude

Longitute of the specific party record.

 <longitude>13.1029639</longitude> 
/b24Message/partyData/party/location/longitude Number 24000 24
Party Banner

The banner/store concept used for the specific party record.

 <property name="banner">Example banner</property> 
/b24Message/partyData/party/property[@name="banner"] Text 25000 25
Party Opening Date

The grand opening/premiere date of the specific party record.

 <property name="openingDate">2022-06-02</property> 
/b24Message/partyData/party/property[@name="openingDate"] Date/Time 26000 26
Party Internal Id

Internal/local system reference/store number of the specified party record.

 <property name="internalId">001</property> 
/b24Message/partyData/party/property[@name="internalId"] Text 27000 27