camid:sql:sp_createnewaddress
Inhaltsverzeichnis
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) | |
country | Gibt die Bezeichnung des Landes an. Dieser Parameter ist nur nötig, wenn der Ort nicht gefunden wurde, um diesen dann neu anlegen zu können. | nvarchar(50) | |
countryNo | Gibt den Ländercode des Landes an. Dieser Parameter ist nur nötig, wenn der Ort nicht gefunden wurde, um diesen dann neu anlegen zu können. | nvarchar(50) | |
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) | |
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. Wird keine Adressgruppe gefunden, wird nach der Adressgruppe gesucht, die in xPress als Standard definiert wurde. |
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. Wird keine Kondition gefunden, wird nach der Kondition gesucht, die in xPress als Standard definiert wurde. | 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 | Gibt die Id der Branche der Adresse an. | uniqueidentifier | |
brancheName | Ist die Id der Branche nicht bekannt, kann mit diesem Parameter nach der Nummer oder Bezeichnung der Branche gesucht werden. | nvarchar(100) | |
legalFormId | Gibt die Id der Rechtsform der Adresse an. Diese wird standardmäßig richtig zugewiesen, je nach dem, ob die Firma oder Vor- und Nachname der Adresse definiert ist. Dieser Vorschlag kann mir diesem Parameter allerdings überschrieben werden. | uniqueidentifier | |
legalFormName | Ist die Id der Rechtsform nicht bekannt, kann mit diesem Parameter nach der Nummer oder der Bezeichnung der Rechtsform gesucht werden. | nvarchar(100) | |
description | Defniert eine allgemeine Beschreibung für die Adresse. | nvarchar(max) | |
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 |
camid/sql/sp_createnewaddress.txt · Zuletzt geändert: 30.08.2021 08:52 von Benjamin Marzoner