Gespeicherte Prozedur: SP_CreateNewAddress

Die gespeicherte Prozedur SP_CreateNewAddress erzeugt eine neue Adresse mit deren Ansprechpartner in der xPress Datenbank. Optional kann eine bereits vorhandene Adresse mit dieser Prozedur auch upgedatet werden.

Die Datentypen beziehen sich auf jene des Microsoft SQL-Servers.

Parameter

Name	Beschreibung	Datentyp	Pflichtfeld
addressNo	Definiert die Adressnummer der Adresse. Diese Nummer muss eindeutig sein. Anhand dieser Nummer werden die Adresskontakte (Ansprechpartner) der Hauptadresse zugewiesen. Auch bei einer eventuellen Aktualisierung der Adresse wird nach dieser Nummer gesucht und diese Adresse aktualisiert.	nvarchar(50)	x
mainAddressNo	Dieses Feld ist nur relevant, wenn die Adresse ein Adresskontakt (Ansprechpartner) ist. Dies ist im Prinzip eine normale Adresse, diese wird jedoch einer übergeordneter Adresse zugewiesen. In diesem Feld wird die Adressnummer der Hauptadresse angegeben.	nvarchar(50)
addressTypeId	Gibt die Id des Adresstypes an. Diese ist nur bei einer Adresse relevant, die als Adresskontakt definiert ist. Der Adresstyp definiert, ob der Kontakt z.B. ein Mitarbeiter oder ein Ansprechpartner ist. Eine Rechnungs- oder Lieferadresse wird auch als Adresskontakt angegeben. Wird dieses Feld angegeben, muss die Id des gewünschten Adresstyps angegeben, die der Adresstyp in xPress hat.	uniqueidentifier
addressTypeName	Wenn der Parameter addressTypeId nicht bekannt ist, kann stattdessen durch diesen Parameter mit der Bezeichnung nach dem gewünschten Adresstyp gesucht werden.	nvarchar(50)
company	Gibt die Bezeichnung der Firma an. Ist dieser Parameter definiert, wird der Adresse als Rechtsform automatisch der Typ Geschäftlich zugewiesen. Die Rechtsform kann mit dem Paramter legalFormId explizit gesetzt werden.	nvarchar(150)	Nur wenn Vor- und Nachname nicht definiert.
firstName	Definiert den Vorname der Adresse. Zusätzlich muss auch der Nachname verpflichtend angegeben werden. Ist dieser Parameter definiert, wird der Adresse als Rechtsform automatisch der Typ Person zugewiesen. Die Rechtsform kann mit dem Paramter legalFormId explizit gesetzt werden.	nvarchar(100)	Nur wenn Firma nicht definiert
lastName	Definiert den Nachname der Adresse. Zusätzlich muss auch der Vorname verpflichtend angegeben werden. Ist dieser Parameter definiert, wird der Adresse als Rechtsform automatisch der Typ Geschäftlich zugewiesen. Die Rechtsform kann mit dem Paramter legalFormId explizit gesetzt werden.	nvarchar(100)	Nur wenn Firma nicht definiert
street	Gibt die Strasse der Adresse an.	nvarchar(100)
cityId	Gibt Id des Ortes der Adresse an.	uniqueidentifier
zipCode	Ist die Id des Ortes (cityId) nicht bekannt, kann anhand diesem Parameter nach einer Postleitzahl gesucht werden. Zusätzlich muss noch der Parameter city angegeben werden.	nvarchar(10)
city	Dieser Parameter definiert die Bezeichnung des Ortes, wenn dessen Id (cityId) nicht bekannt ist. In Kombination mit dem Parameter zipCode wird nach dem Ort gesucht.	nvarchar(100)
phoneNumber1	Definiert die erste Telefonnummer.	nvarchar(50)
phoneText1	Definiert die Beschreibung zur ersten Telefonnummer, z.B. geschäftlich, mobil…	nvarchar(100)
phoneNumber2	Definiert die zweite Telefonnummer.	nvarchar(50)
phoneText2	Definiert die Beschreibung zur zweiten Telefonnummer, z.B. geschäftlich, mobil…	nvarchar(100)
phoneNumber3	Definiert die dritte Telefonnummer.	nvarchar(50)
phoneText3	Definiert die Beschreibung zur dritten Telefonnummer, z.B. geschäftlich, mobil…	nvarchar(100)
faxNumber	Definiert die Faxnummer der Adresse.	nvarchar(50)
email	Definiert die Emailadresse.	nvarchar(100)
website	Definiert die Website der Adresse.	nvarchar(100)
vartaxNo	Definiert die UID - Nummer der Adresse. Dieser Parameter ist nur bei geschäftlichen Adressen relevant. Aus dem Prefix und der hier definierten Nummer ergibt sich dann die vollständige UID - Nummer. Aus diesem Grund darf das zweistellige Länderkennzeichen hier nicht mit angegeben werden. Dafür ist das Prefix vorgesehen.	nvarchar(50)
vartaxNoPrefix	Definiert das Prefix der UID - Nummer.	nvarchar(2)
registerNo	Definiert die Steuernummer der Adresse. Diese ist nur bei Privatpersonen relevant.	nvarchar(50)
customerNo	Definiert die Kundennnummer der Adresse. Diese kann frei verwendet werden. Bei einigen Schnittstellen (z.B. Buchhaltung) wird auf dieses Feld zurückgegriffen.	nvarchar(50)
vendorNo	Definiert die Lieferantennummer der Adresse. Diese kann frei verwendet werden. Bei einigen Schnittstellen (z.B. Buchhaltung, digitale Bestellung) wird auf dieses Feld zurückgegriffen.	nvarchar(50)
vendorClientNo	Definiert die Lieferanten Kundennummer der Adresse. Diese kann frei verwendet werden. Bei einigen Schnittstellen (z.B. Buchhaltung) wird auf dieses Feld zurückgegriffen.	nvarchar(50)
addressGroupId	Gibt die Id der Adressgruppe, die dieser Adresse zugewiesen werden soll. Die Adressgruppe gibt an, ob die Adresse ein Kunde, Lieferant, Mitarbeiter usw. ist.	uniqueidentifier	x
addressGroupName	Ist die Id der Adressgruppe nicht bekannt, kann mit diesem Parameter nach der Bezeichnung nach einer Adressgruppe gesucht werden.	nvarchar(100)	wenn der Parameter addressGroupId nicht definiert ist.
conditionId	Gibt die Id der Zahlungskondition an.	uniqueidentifier
conditionName	Ist die Id der Zahlungskondition nicht bekannt, kann mit diesem Parameter nach der Nummer oder Bezeichnung der Zahlungskondition gesucht werden.	nvarchar(50)
taxId	Definiert die Id der Steuer der Adresse.	uniqueidentifier
taxName	Ist die Id der Steuer nicht bekannt, kann mit diesem Parameter nach der Bezeichnung der Steuer gesucht werden. Wird keine Steuer gefunden, wird noch nach der Steuer gesucht, die in xPress als Standard hinterlegt wurde.	nvarchar(100)
brancheId
brancheName
legalFormId
legalFormName
description
updateIfExists	Gibt an, ob ein bereits bestehender Artikel mit den angegebenen Daten aktualisiert werden soll oder nicht.	bit
createdBy	Gibt den Namen an, welcher diese Methode aufruft. Dieser Wert wird in die Spalte UserCreated geschrieben, um nachvollziehen zu können, wer diesen Artikel erzeugt hat.	nvarchar(30)	x