Module endpoint.Offerte

Offerte - CASYMIR REST API Standard Endpunkt Offerte

Methods

Methods

Auftrag-Request-Handler (Internal)

Offerte (DB, EndUrl, Pattern, Methode, UserName, QueryStr, BodyTable) Endpunkt Handler.

Request GET Offerte

GET-Request-Field-Definition
GET-Request-Usage
GET-Response-Field-Definition
GET-Response

Request POST Offerte

POST-Request-Field-Definition
POST-Request-Usage
POST-Request-Usage
POST-Request-Usage
POST-Response-Field-Definition
POST-Response
POST-Request-Field-Definition
POST-Request-Usage

Request PATCH Offerte

PATCH-Request-Field-Definition
PATCH-Request-Usage
PATCH-Request-Usage
PATCH-Response-Field-Definition
PATCH-Response


Methods

Methods

Usage:

    GET, POST, PATCH

Auftrag-Request-Handler (Internal)

Offerte (DB, EndUrl, Pattern, Methode, UserName, QueryStr, BodyTable)
Endpunkt Handler.

Parameters:

  • DB UserData -- Datenbank Verbindung
  • EndUrl string -- Enthält die Ausgelesene URI aus der Datenbank
  • Pattern string -- Enthält den Patter Teil der URI else nil
  • Methode string -- HTTP Methode
  • UserName string -- Benutzer der Angemeldet wurde
  • QueryStr string -- Orginal String ohne Hex Zeichen
  • BodyTable table -- Request Body

Returns:

    table retBody

Request GET Offerte

GET-Request-Field-Definition

Fields:

  • OffertNr varchar(16) -- Offerten Nummer
GET-Request-Usage

Usage:

    GET https://casyrest.opag.loc/www/offerte?OffertNr={OffertNr} HTTP/1.1
GET-Response-Field-Definition

Fields:

  • GrundDaten table
  • StaoNr int -- Auftragsstandort
  • KundNr char(8) -- CASYMIR Kundennummer
  • AuftKomment varchar(255) -- Auftragskommentar
  • Template bool -- true = keinem Kunden zugewiesen, false = Kunden zugewiesen
  • KundBedBez varchar(255) -- Bezeichnung der Bezahlbedingung - übersetzt nach Sprache Kontakt,
  • KundBedTyp tinyint -- Zahlungsbedingung Kunde
  • AuftBestellTUTC string -- UTC Tag Bestellung
  • AuftLieferTUTC string -- UTC Liefertermin
  • AuftLiefKost money -- Lieferkosten
  • AuftStatus char(1) -- N: Neu, O: Offen, A: Abgeschlossen, P = Offerte
  • AuftBestellRef varchar(60) -- Bestellreferenz
  • WaehrAbk char(4) -- Währungsabkürzung
  • AuftWUST money -- Steuer Betrag
  • AuftBrutto money -- Brutto Betrag
  • AuftNetto money -- Netto Betrag
  • AuftNr varchar(10) -- Auftragsnummer
  • AuftBez varchar(80) -- Auftragsbezeichung
  • AuftBestellNr varchar(36) -- Bestellnummer Fremdsystem
  • Tabelle Adressen mit KontaktAdr, LiefAdr, RechAdr
  • AdrNr int -- CASYMIR Adressnummer
  • AdrFirma varchar(36) -- Firmennamen
  • AdrFirma2 varchar(36) -- Firmennamen-Zusatz
  • AdrVorname varchar(36) --Vorname
  • AdrName varchar(36) -- Nachname
  • AdrAdresse1 varchar(36) -- Adressfeld 1
  • AdrAdresse2 varchar(36) -- Adressfeld 2
  • AdrTelex varchar(28) -- Mobilnummer
  • AdrTf1 varchar(28) -- Telefonnummer 1
  • AdrTf2 varchar(28) -- Telefonnummer 2
  • AdrFax varchar(28) -- Faxnummer
  • OrtName varchar(48) -- Ortsnamen
  • OrtPLZ varchar(10) -- Postleitzahl
  • OrtLand varchar(4) -- Land ISO 3166 ALPHA-2
  • EmailAdress varchar(255) -- Emailadresse
  • Positionen table
  • PosNr int -- CASYMIR Positionsnummer
  • VisPosNr int -- Ordnungsnummer
  • ArtNr char(15) -- CASYMIR Artikelnummer
  • PosBez varchar(2048) -- Positionsbezeichnung
  • PosAnzBest float -- Anzahl/Menge des bestellten Artikels in GE
  • PosPreisBasis float -- Preisbasis
  • PosPreisEinzel float -- Einzelpreis
  • PosPreisTotal float -- Totalpreis
  • PosPreisWUSTBetrag float -- Steuerwert der Position
  • VPEAnzBest float -- Anzahl/Menge in Verpackungseinheit
  • VPEPreisEinzel float -- Einzelpreis des Verpackungseinheits
  • VPEinheit varchar(30) -- Verpackungseinheit
  • WUSTSatz float -- Prozentsatz des Mehrwertsteuers
  • GRabSatz float -- Prozentsatz des Rabattes
  • GRabBez float -- Bezeichnung des Rabattes
  • MWSTRekapitulation table -- MWST Rekapitulation des Auftrags/Offerte
  • Abschnitt string -- fix UST-Rekap
  • WaehrAbk char(4) -- Währungsabkürzung
  • PosWUST float -- Steuerwert der Position zusammen geführt auf den Satz
  • PosVSTSZiffer string -- Ziffer des Steuerformulares für den Vorsteuerbetrag
  • PosWUSTSatz float -- Prozentsatz des Mehrwertsteuers
  • PosWUSTBez string -- Bezeichnung des Steuersatzes
  • PosBetragNetto float -- Netto Betrag der Positionen zusammen geführt auf den Satz
  • PosUSTSZiffer string -- Ziffer des Steuerformulares für den Umsatzsteuerbetrag
  • PosWUSTCode string -- Interne Casymir Code
  • PosWUSTKlasse string -- Angaben zum Aufbau der Umsatzsteuererklärung, D Deutsch, C Schweiz, X andere
  • PosUSTUZiffer string -- Ziffer des Steuerformulares für den Umsatzbetrag.
  • Zahlung table -- Zusatz Informationen von Zahlungen (optional)
  • Bezeichnung varchar(255) -- Bezeichnungs z.B TransID
  • Wert varchar(200) -- Wert z.B Nummer der TransID
  • Key varchar(12) -- Eindeutige Zuordnung im Auftrag
GET-Response

Usage:

    {
   "count": 4,
   "success": true,
   "data":    {
      "Adressen":       {
         "KontaktAdr":          {
            "AdrFirma": "Bauer-Lustig",
            "AdrTf1": "0049 6831 555 54",
            "AdrNr": 146,
            "AdrAdresse2": "Hauptstraße 15",
            "AdrAdresse1": "Heilpraktikerin",
            "ISOLandA2": "DE",
            "EmailAdress": "uzuwe@d",
            "OrtLand": "D",
            "OrtName": "Schwalbach",
            "AdrVorname": "Frau Dipl. Ing.",
            "AdrName": "Lelia",
            "OrtPLZ": "66773"
         },
         "LiefAdr":          {
            "AdrFirma": "Bauer-Lustig",
            "AdrTf1": "0049 6831 555 54",
            "AdrNr": 146,
            "AdrAdresse2": "Hauptstraße 15",
            "AdrAdresse1": "Heilpraktikerin",
            "ISOLandA2": "DE",
            "EmailAdress": "uzuwe@d",
            "OrtLand": "D",
            "OrtName": "Schwalbach",
            "AdrVorname": "Frau Dipl. Ing.",
            "AdrName": "Lelia",
            "OrtPLZ": "66773"
         },
         "RechAdr":          {
            "AdrFirma": "Bauer-Lustig",
            "AdrTf1": "0049 6831 555 54",
            "AdrNr": 146,
            "AdrAdresse2": "Hauptstraße 15",
            "AdrAdresse1": "Heilpraktikerin",
            "ISOLandA2": "DE",
            "EmailAdress": "uzuwe@d",
            "OrtLand": "D",
            "OrtName": "Schwalbach",
            "AdrVorname": "Frau Dipl. Ing.",
            "AdrName": "Lelia",
            "OrtPLZ": "66773"
         }
      },
      "Positionen":       [
                  {
            "WUSTSatz": 19,
            "PosAnzBest": 1,
            "PosPreisBasis": 1,
            "VPEinheit": "gf100ml",
            "VisPosNr": 1,
            "PosBez": "Sepanol® KM",
            "VPEPreisEinzel": 2.65,
            "VPEAnzBest": 10,
            "ArtNr": "P201",
            "PosPreisEinzel": 26.5,
            "PosPreisTotal": 26.5,
            "PosNr": 1
         },
                  {
            "PosAnzBest": 5,
            "PosPreisBasis": 1,
            "VPEinheit": "",
            "VisPosNr": 2,
            "PosBez": "Zuckerlikör 100 ml Flasche",
            "WUSTSatz": 19,
            "ArtNr": "C213",
            "PosPreisEinzel": 8.7,
            "PosPreisTotal": 43.5,
            "PosNr": 2
         }
      ],
      "OffertNr": "10214",
      "GrundDaten":       {
         "StaoNr": 1,
         "KundNr": "100075",
         "AuftKomment": "",
         "Template": false,
         "KundBedBez": "Fällig innerhalb 14 Tagen ohne Abzug",
         "AuftBrutto": 261.8,
         "KundBedTyp": 2,
         "AuftBestellTUTC": "2022-08-26T00:00:00",
         "AuftLieferTUTC": "2023-08-26T13:30:00",
         "AuftLiefKost": 150,
         "AuftBestellRef": "",
         "AuftWUST": 41.8,
         "WaehrAbk": "CHF",
         "AuftNetto": 220
      }
   }
}

Request POST Offerte

POST-Request-Field-Definition
Das Objekt Adressen ist optional

Fields:

  • GrundDaten table
  • KundNr char(8) -- CASYMIR Kundennummer (optional)
  • AuftBestellNr varchar(36) -- Bestellnummer Fremdsystem (optional)
  • AuftBez varchar(80) -- Auftragsbezeichung (optional)
  • AuftBestellRef varchar(60) -- Bestellreferenz (optional)
  • AuftBestellT char(20) -- Bestelldatum ISO 8601 (optional)
  • AuftLieferT char(20) -- Lieferdatum ISO 8601 (optional)
  • AuftKomment varchar(255) -- Auftragskommentar (optional)
  • WaehrAbk char(4) -- Währungsabkürzung Default Leitwährung (optional)
  • Adressen table (optional)
  • LiefAdr table ,RechAdr,KontaktAdr -- können pro Offerte vom Kunden übersteuert werden (optional)
  • AdrSprache string -- Sprache des Kunden ISO-639-2B Mapping
  • EmailAdress varchar(255) -- EmailAdresse (optional)
  • AdrAdresse1 varchar(60) -- Strasse Hausnummer
  • AdrAdresse2 varchar(60) -- Zusatz (optional)
  • AdrAnrede int -- Anrede 0 = Firma/Allgemein, 1 = Herr, 2 = Frau
  • AdrFax varchar(28) -- Faxnummer (optional)
  • AdrFirma varchar(36) -- Firmenname es muss AdrFirma oder AdrName angegeben werden (optional)
  • AdrFirma2 varchar(36) -- Firmennamen zusatz (optional)
  • AdrVorname varchar(36) --Vorname (optional)
  • AdrName varchar(36) -- Nachname es muss AdrFirma oder AdrName angegeben werden (optional)
  • AdrTelex varchar(28) -- Mobilnummer (optional)
  • AdrTf1 varchar(28) -- Direkt Telefon (optional)
  • AdrTf2 varchar(28) -- Telefon Zentrale (optional)
  • OrtLand varchar(4) -- Land ISO 3166 ALPHA-2
  • OrtName varchar(48) -- Ortsnamen
  • OrtPLZ varchar(10) -- Postleitzahl
  • AdrCheck int -- Macht eine Prüfung des Ortsnamen zur Postleitzahl und Korrigiert den OrtsNamen. Default für CH Adressen 1 sonst 0
  • Positionen table -- Liste mit Positionen
  • ArtNr char(15) -- CASYMIR Artikelnummer
  • Menge float -- Anzahl/Menge des bestellten Artikels in Grundeinheit
  • VPEinheit varchar(30) -- Verpackungseinheit (optional)
  • GRabSatz float -- Prozentsatz des Rabattes (optional)
POST-Request-Usage
Offerten ohne KundenNr werden als Template Offerten abgespeichert eine Umwandlung zum Kunden ist nur möglich wenn die Preisliste, KTNr WUSTCode und Währung passend ist. Alternativ kann eine Neue Offerte erstellt werden mit der KundenNr.

Usage:

    POST https://casyrest.opag.loc/www/offerte HTTP/1.1

{
  "GrundDaten": {
    "KundNr": "100075",
    "AuftBestellNr": "110011",
    "WaehrAbk": "CHF"
  },
  "Adressen": {
    "LiefAdr": {
      "AdrName": "Lustig",
      "AdrSprache": "ger",
      "AdrAnrede": 1,
      "AdrVorname": "Bauer",
      "OrtName": "Binningen",
      "AdrAdresse1": "Oberwilerstrasse 56",
      "OrtLand": "CH",
      "OrtPLZ": "4102"
    },
    "KontaktAdr": {
      "AdrName": "Lustig",
      "AdrSprache": "ger",
      "AdrAnrede": 1,
      "AdrVorname": "Bauer",
      "OrtName": "Binningen",
      "AdrAdresse1": "Oberwilerstrasse 56",
      "OrtLand": "CH",
      "OrtPLZ": "4102"
    },
    "RechAdr": {
      "AdrName": "Lustig",
      "AdrSprache": "ger",
      "AdrAnrede": 1,
      "AdrVorname": "Bauer",
      "OrtName": "Binningen",
      "AdrAdresse1": "Oberwilerstrasse 56",
      "OrtLand": "CH",
      "OrtPLZ": "4102"
    }

    },
  "Positionen": [{
      "ArtNr": "C210",
      "PosBez": "Eierlikör 100 ml Flasche",
      "Menge": 10
    },
    {
      "ArtNr": "C213",
      "VisPosNr": "2",
      "PosBez": "Zuckerlikör 100 ml Flasche",
      "Menge": 5
    },
    {
      "ArtNr": "C201",
      "Menge": 5,
      "VPEinheit": "s12"
    }
  ]
 }
POST-Request-Usage

Usage:

    POST https://casyrest.opag.loc/www/offerte HTTP/1.1

{
  "GrundDaten": {
    "KundNr": "100075"
  },
  "Positionen": [
  {
    "ArtNr": "C210",
  	 "Menge": 10
  },
  {
    "ArtNr": "C213",
    "VisPosNr": "2",
    "PosBez": "Zuckerlikör 100 ml Flasche",
    "Menge": 5
  }]
}
POST-Request-Usage

Usage:

    Offerte ohne Kunde
POST https://casyrest.opag.loc/www/offerte HTTP/1.1

{
  "GrundDaten": {
     "OrtLand": "CH",
     "WaehrAbk": "CHF"
  },
  "Positionen": [
  {
    "ArtNr": "C210",
  	 "Menge": 10
  },
  {
    "ArtNr": "C213",
    "VisPosNr": "2",
    "PosBez": "Zuckerlikör 100 ml Flasche",
    "Menge": 5
  }]
}
POST-Response-Field-Definition

Fields:

  • GrundDaten table
  • StaoNr int -- Auftragsstandort
  • KundNr char(8) -- CASYMIR Kundennummer
  • AuftKomment varchar(255) -- Auftragskommentar
  • Template bool -- true = keinem Kunden zugewiesen, false = Kunden zugewiesen
  • KundBedBez varchar(255) -- Bezeichnung der Bezahlbedingung - übersetzt nach Sprache Kontakt,
  • KundBedTyp tinyint -- Zahlungsbedingung Kunde
  • AuftBestellTUTC string -- UTC Tag Bestellung
  • AuftLieferTUTC string -- UTC Liefertermin
  • AuftLiefKost money -- Lieferkosten
  • AuftStatus char(1) -- N: Neu, O: Offen, A: Abgeschlossen, P = Offerte
  • AuftBestellRef varchar(60) -- Bestellreferenz
  • WaehrAbk char(4) -- Währungsabkürzung
  • AuftWUST money -- Steuer Betrag
  • AuftBrutto money -- Brutto Betrag
  • AuftNetto money -- Netto Betrag
  • AuftNr varchar(10) -- Auftragsnummer
  • AuftBez varchar(80) -- Auftragsbezeichung
  • AuftBestellNr varchar(36) -- Bestellnummer Fremdsystem
  • Tabelle Adressen mit KontaktAdr, LiefAdr, RechAdr
  • AdrNr int -- CASYMIR Adressnummer
  • AdrFirma varchar(36) -- Firmennamen
  • AdrFirma2 varchar(36) -- Firmennamen-Zusatz
  • AdrVorname varchar(36) --Vorname
  • AdrName varchar(36) -- Nachname
  • AdrAdresse1 varchar(36) -- Adressfeld 1
  • AdrAdresse2 varchar(36) -- Adressfeld 2
  • AdrTelex varchar(28) -- Mobilnummer
  • AdrTf1 varchar(28) -- Telefonnummer 1
  • AdrTf2 varchar(28) -- Telefonnummer 2
  • AdrFax varchar(28) -- Faxnummer
  • OrtName varchar(48) -- Ortsnamen
  • OrtPLZ varchar(10) -- Postleitzahl
  • OrtLand varchar(4) -- Land ISO 3166 ALPHA-2
  • EmailAdress varchar(255) -- Emailadresse
  • Positionen table
  • PosNr int -- CASYMIR Positionsnummer
  • VisPosNr int -- Ordnungsnummer
  • ArtNr char(15) -- CASYMIR Artikelnummer
  • PosBez varchar(2048) -- Positionsbezeichnung
  • PosAnzBest float -- Anzahl/Menge des bestellten Artikels in GE
  • PosPreisBasis float -- Preisbasis
  • PosPreisEinzel float -- Einzelpreis
  • PosPreisTotal float -- Totalpreis
  • PosPreisWUSTBetrag float -- Steuerwert der Position
  • VPEAnzBest float -- Anzahl/Menge in Verpackungseinheit
  • VPEPreisEinzel float -- Einzelpreis des Verpackungseinheits
  • VPEinheit varchar(30) -- Verpackungseinheit
  • WUSTSatz float -- Prozentsatz des Mehrwertsteuers
  • GRabSatz float -- Prozentsatz des Rabattes
  • GRabBez float -- Bezeichnung des Rabattes
  • MWSTRekapitulation table -- MWST Rekapitulation des Auftrags/Offerte
  • Abschnitt string -- fix UST-Rekap
  • WaehrAbk char(4) -- Währungsabkürzung
  • PosWUST float -- Steuerwert der Position zusammen geführt auf den Satz
  • PosVSTSZiffer string -- Ziffer des Steuerformulares für den Vorsteuerbetrag
  • PosWUSTSatz float -- Prozentsatz des Mehrwertsteuers
  • PosWUSTBez string -- Bezeichnung des Steuersatzes
  • PosBetragNetto float -- Netto Betrag der Positionen zusammen geführt auf den Satz
  • PosUSTSZiffer string -- Ziffer des Steuerformulares für den Umsatzsteuerbetrag
  • PosWUSTCode string -- Interne Casymir Code
  • PosWUSTKlasse string -- Angaben zum Aufbau der Umsatzsteuererklärung, D Deutsch, C Schweiz, X andere
  • PosUSTUZiffer string -- Ziffer des Steuerformulares für den Umsatzbetrag.
POST-Response

Usage:

    {
   "count": 4,
   "success": true,
   "data":    {
      "Adressen":       {
         "KontaktAdr":          {
            "AdrFirma": "Bauer-Lustig",
            "AdrTf1": "0049 6831 555 54",
            "AdrNr": 146,
            "AdrAdresse2": "Hauptstraße 15",
            "AdrAdresse1": "Heilpraktikerin",
            "ISOLandA2": "DE",
            "EmailAdress": "uzuwe@d",
            "OrtLand": "D",
            "OrtName": "Schwalbach",
            "AdrVorname": "Frau Dipl. Ing.",
            "AdrName": "Lelia",
            "OrtPLZ": "66773"
         },
         "LiefAdr":          {
            "AdrFirma": "Bauer-Lustig",
            "AdrTf1": "0049 6831 555 54",
            "AdrNr": 146,
            "AdrAdresse2": "Hauptstraße 15",
            "AdrAdresse1": "Heilpraktikerin",
            "ISOLandA2": "DE",
            "EmailAdress": "uzuwe@d",
            "OrtLand": "D",
            "OrtName": "Schwalbach",
            "AdrVorname": "Frau Dipl. Ing.",
            "AdrName": "Lelia",
            "OrtPLZ": "66773"
         },
         "RechAdr":          {
            "AdrFirma": "Bauer-Lustig",
            "AdrTf1": "0049 6831 555 54",
            "AdrNr": 146,
            "AdrAdresse2": "Hauptstraße 15",
            "AdrAdresse1": "Heilpraktikerin",
            "ISOLandA2": "DE",
            "EmailAdress": "uzuwe@d",
            "OrtLand": "D",
            "OrtName": "Schwalbach",
            "AdrVorname": "Frau Dipl. Ing.",
            "AdrName": "Lelia",
            "OrtPLZ": "66773"
         }
      },
      "Positionen":       [
                  {
            "WUSTSatz": 19,
            "PosAnzBest": 1,
            "PosPreisBasis": 1,
            "VPEinheit": "gf100ml",
            "VisPosNr": 1,
            "PosBez": "Sepanol® KM",
            "VPEPreisEinzel": 2.65,
            "VPEAnzBest": 10,
            "ArtNr": "P201",
            "PosPreisEinzel": 26.5,
            "PosPreisTotal": 26.5,
            "PosNr": 1
         },
                  {
            "PosAnzBest": 5,
            "PosPreisBasis": 1,
            "VPEinheit": "",
            "VisPosNr": 2,
            "PosBez": "Zuckerlikör 100 ml Flasche",
            "WUSTSatz": 19,
            "ArtNr": "C213",
            "PosPreisEinzel": 8.7,
            "PosPreisTotal": 43.5,
            "PosNr": 2
         }
      ],
      "OffertNr": "10214",
      "GrundDaten":       {
         "StaoNr": 1,
         "KundNr": "100075",
         "AuftKomment": "",
         "Template": false,
         "KundBedBez": "Fällig innerhalb 14 Tagen ohne Abzug",
         "AuftBrutto": 261.8,
         "KundBedTyp": 2,
         "AuftBestellTUTC": "2022-08-26T00:00:00",
         "AuftLieferTUTC": "2023-08-26T13:30:00",
         "AuftLiefKost": 150,
         "AuftBestellRef": "",
         "AuftWUST": 41.8,
         "WaehrAbk": "CHF",
         "AuftNetto": 220
      }
   }
}
POST-Request-Field-Definition
Das Objekt Adressen ist optional

Fields:

  • GrundDaten table
  • KundNr char(8) -- CASYMIR Kundennummer (optional)
  • AuftBestellNr varchar(36) -- Bestellnummer Fremdsystem (optional)
  • AuftBez varchar(80) -- Auftragsbezeichung (optional)
  • AuftBestellRef varchar(60) -- Bestellreferenz (optional)
  • AuftBestellT char(20) -- Bestelldatum ISO 8601 (optional)
  • AuftLieferT char(20) -- Lieferdatum ISO 8601 (optional)
  • AuftKomment varchar(255) -- Auftragskommentar (optional)
  • WaehrAbk char(4) -- Währungsabkürzung Default Leitwährung (optional)
  • Adressen table (optional)
  • LiefAdr table ,RechAdr,KontaktAdr -- können pro Offerte vom Kunden übersteuert werden (optional)
  • AdrSprache string -- Sprache des Kunden ISO-639-2B Mapping
  • EmailAdress varchar(255) -- EmailAdresse (optional)
  • AdrAdresse1 varchar(60) -- Strasse Hausnummer
  • AdrAdresse2 varchar(60) -- Zusatz (optional)
  • AdrAnrede int -- Anrede 0 = Firma/Allgemein, 1 = Herr, 2 = Frau
  • AdrFax varchar(28) -- Faxnummer (optional)
  • AdrFirma varchar(36) -- Firmenname es muss AdrFirma oder AdrName angegeben werden (optional)
  • AdrFirma2 varchar(36) -- Firmennamen zusatz (optional)
  • AdrVorname varchar(36) --Vorname (optional)
  • AdrName varchar(36) -- Nachname es muss AdrFirma oder AdrName angegeben werden (optional)
  • AdrTelex varchar(28) -- Mobilnummer (optional)
  • AdrTf1 varchar(28) -- Direkt Telefon (optional)
  • AdrTf2 varchar(28) -- Telefon Zentrale (optional)
  • OrtLand varchar(4) -- Land ISO 3166 ALPHA-2
  • OrtName varchar(48) -- Ortsnamen
  • OrtPLZ varchar(10) -- Postleitzahl
  • AdrCheck int -- Macht eine Prüfung des Ortsnamen zur Postleitzahl und Korrigiert den OrtsNamen. Default für CH Adressen 1 sonst 0
  • Positionen table -- Liste mit Positionen
  • ArtNr char(15) -- CASYMIR Artikelnummer
  • Menge float -- Anzahl/Menge des bestellten Artikels in Grundeinheit
  • VPEinheit varchar(30) -- Verpackungseinheit (optional)
  • GRabSatz float -- Prozentsatz des Rabattes (optional)
POST-Request-Usage
Offerten ohne KundenNr werden als Template Offerten abgespeichert eine Umwandlung zum Kunden ist nur möglich wenn die Preisliste, KTNr WUSTCode und Währung passend ist. Alternativ kann eine Neue Offerte erstellt werden mit der KundenNr.

Usage:

    POST https://casyrest.opag.loc/www/offerte HTTP/1.1

{
  "GrundDaten": {
    "KundNr": "100075",
    "AuftBestellNr": "110011",
    "WaehrAbk": "CHF"
  },
  "Adressen": {
    "LiefAdr": {
      "AdrName": "Lustig",
      "AdrSprache": "ger",
      "AdrAnrede": 1,
      "AdrVorname": "Bauer",
      "OrtName": "Binningen",
      "AdrAdresse1": "Oberwilerstrasse 56",
      "OrtLand": "CH",
      "OrtPLZ": "4102"
    },
    "KontaktAdr": {
      "AdrName": "Lustig",
      "AdrSprache": "ger",
      "AdrAnrede": 1,
      "AdrVorname": "Bauer",
      "OrtName": "Binningen",
      "AdrAdresse1": "Oberwilerstrasse 56",
      "OrtLand": "CH",
      "OrtPLZ": "4102"
    },
    "RechAdr": {
      "AdrName": "Lustig",
      "AdrSprache": "ger",
      "AdrAnrede": 1,
      "AdrVorname": "Bauer",
      "OrtName": "Binningen",
      "AdrAdresse1": "Oberwilerstrasse 56",
      "OrtLand": "CH",
      "OrtPLZ": "4102"
    }

    },
  "Positionen": [{
      "ArtNr": "C210",
      "PosBez": "Eierlikör 100 ml Flasche",
      "Menge": 10
    },
    {
      "ArtNr": "C213",
      "VisPosNr": "2",
      "PosBez": "Zuckerlikör 100 ml Flasche",
      "Menge": 5
    },
    {
      "ArtNr": "C201",
      "Menge": 5,
      "VPEinheit": "s12"
    }
  ]
 }

Request PATCH Offerte

PATCH-Request-Field-Definition

Fields:

  • KundNr char(8) -- CASYMIR Kundennummer
  • OffertNr varchar(16) -- OffertenNr
  • GrundDaten table (optional)
  • KundNr char(8) -- CASYMIR Kundennummer
  • Positionen table (optional)
  • PosNr int -- CASYMIR Positionsnummer (optional)
  • ArtNr char(15) -- CASYMIR Artikelnummer (optional)
  • PosBez varchar(2048) -- Positionsbezeichnung (optional)
  • Menge float -- Anzahl/Menge
  • GRabSatz float -- Prozentsatz des Rabattes (optional)
  • Adressen table (optional)
  • LiefAdr table ,RechAdr,KontaktAdr -- können pro Offerte vom Kunden übersteuert werden (optional)
  • AdrSprache string -- Sprache des Kunden ISO-639-2B Mapping
  • EmailAdress varchar(255) -- EmailAdresse (optional)
  • AdrAdresse1 varchar(60) -- Strasse Hausnummer
  • AdrAdresse2 varchar(60) -- Zusatz (optional)
  • AdrAnrede int -- Anrede 0 = Firma/Allgemein, 1 = Herr, 2 = Frau
  • AdrFax varchar(28) -- Faxnummer (optional)
  • AdrFirma varchar(36) -- Firmenname es muss AdrFirma oder AdrName angegeben werden (optional)
  • AdrFirma2 varchar(36) -- Firmennamen zusatz (optional)
  • AdrVorname varchar(36) --Vorname (optional)
  • AdrName varchar(36) -- Nachname es muss AdrFirma oder AdrName angegeben werden (optional)
  • AdrTelex varchar(28) -- Mobilnummer (optional)
  • AdrTf1 varchar(28) -- Direkt Telefon (optional)
  • AdrTf2 varchar(28) -- Telefon Zentrale (optional)
  • OrtLand varchar(4) -- Land ISO 3166 ALPHA-2
  • OrtName varchar(48) -- Ortsnamen
  • OrtPLZ varchar(10) -- Postleitzahl
  • AdrCheck int -- Macht eine Prüfung des Ortsnamen zur Postleitzahl und Korrigiert den OrtsNamen. Default für CH Adressen 1 sonst 0
PATCH-Request-Usage
  • Angaben ohne PosNr werden Hinzugefügt.
  • Menge 0 Löscht die Position.
  • Menge ~= 0 und PosNr wird die Menge Geupdatet.
  • Adressen sind Optional, es muss immer der gesamte Datensatz übergeben werden von der Adresse.

Usage:

    PATCH https://casyrest.opag.loc/www/offerte?OffertNr={OffertNr}&KundNr={KundNr} HTTP/1.1

{
  "Positionen": [
  {
    "ArtNr": "C210",
  	 "Menge": 10
  },
  {
    "Menge": 5,
    "PosNr": 1
  }]
}
PATCH-Request-Usage

Usage:

    Offerte ohne Kunde Funktioniert nur beim Template Offerte (Offerte ohne zuordnung zum Kunden)
PATCH https://casyrest.opag.loc/www/offerte?OffertNr={OffertNr}

{
 "GrundDaten": {
    "KundNr": "100075"
  },
 "Positionen": [
  {
    "PosNr": 1,
  	 "Menge": 10
  },
  {
    "ArtNr": "C213",
    "Menge": 5,
    "GRabSatz": 5
  },
  {
    "PosNr": 3,
    "Menge": 0
  }],
 "Adressen": {
 "LiefAdr": {
   "AdrName": "Lustig",
   "AdrSprache": "ger",
   "AdrAnrede": 1,
   "AdrVorname": "Bauer",
   "OrtName": "Binningen",
   "AdrAdresse1": "Hubert Str. 21",
   "OrtLand": "CH",
   "OrtPLZ": "4102"
 }
}
PATCH-Response-Field-Definition

Fields:

  • GrundDaten table
  • StaoNr int -- Auftragsstandort
  • KundNr char(8) -- CASYMIR Kundennummer
  • AuftKomment varchar(255) -- Auftragskommentar
  • Template bool -- true = keinem Kunden zugewiesen, false = Kunden zugewiesen
  • KundBedBez varchar(255) -- Bezeichnung der Bezahlbedingung - übersetzt nach Sprache Kontakt,
  • KundBedTyp tinyint -- Zahlungsbedingung Kunde
  • AuftBestellTUTC string -- UTC Tag Bestellung
  • AuftLieferTUTC string -- UTC Lieferung
  • AuftLiefKost money -- Lieferkosten
  • AuftStatus char(1) -- N: Neu, O: Offen, A: Abgeschlossen, P = Offerte
  • AuftBestellRef varchar(60) -- Bestellreferenz
  • WaehrAbk char(4) -- Währungsabkürzung
  • AuftWUST money -- Steuer Betrag
  • AuftBrutto money -- Brutto Betrag
  • AuftNetto money -- Netto Betrag
  • AuftNr varchar(10) -- Auftragsnummer
  • AuftBez varchar(80) -- Auftragsbezeichung
  • AuftBestellNr varchar(36) -- Bestellnummer Fremdsystem
  • Tabelle Adressen mit KontaktAdr, LiefAdr, RechAdr
  • AdrNr int -- CASYMIR Adressnummer
  • AdrFirma varchar(36) -- Firmennamen
  • AdrFirma2 varchar(36) -- Firmennamen-Zusatz
  • AdrVorname varchar(36) --Vorname
  • AdrName varchar(36) -- Nachname
  • AdrAdresse1 varchar(36) -- Adressfeld 1
  • AdrAdresse2 varchar(36) -- Adressfeld 2
  • AdrTelex varchar(28) -- Mobilnummer
  • AdrTf1 varchar(28) -- Telefonnummer 1
  • AdrTf2 varchar(28) -- Telefonnummer 2
  • AdrFax varchar(28) -- Faxnummer
  • OrtName varchar(48) -- Ortsnamen
  • OrtPLZ varchar(10) -- Postleitzahl
  • OrtLand varchar(4) -- Land ISO 3166 ALPHA-2
  • EmailAdress varchar(255) -- Emailadresse
  • Positionen table
  • PosNr int -- CASYMIR Positionsnummer
  • VisPosNr int -- Ordnungsnummer
  • ArtNr char(15) -- CASYMIR Artikelnummer
  • PosBez varchar(2048) -- Positionsbezeichnung
  • PosAnzBest float -- Anzahl/Menge des bestellten Artikels in GE
  • PosPreisBasis float -- Preisbasis
  • PosPreisEinzel float -- Einzelpreis
  • PosPreisTotal float -- Totalpreis
  • PosPreisWUSTBetrag float -- Steuerwert der Position
  • VPEAnzBest float -- Anzahl/Menge in Verpackungseinheit
  • VPEPreisEinzel float -- Einzelpreis des Verpackungseinheits
  • VPEinheit varchar(30) -- Verpackungseinheit
  • WUSTSatz float -- Prozentsatz des Mehrwertsteuers
  • GRabSatz float -- Prozentsatz des Rabattes
  • GRabBez float -- Bezeichnung des Rabattes
  • MWSTRekapitulation table -- MWST Rekapitulation des Auftrags/Offerte
  • Abschnitt string -- fix UST-Rekap
  • WaehrAbk char(4) -- Währungsabkürzung
  • PosWUST float -- Steuerwert der Position zusammen geführt auf den Satz
  • PosVSTSZiffer string -- Ziffer des Steuerformulares für den Vorsteuerbetrag
  • PosWUSTSatz float -- Prozentsatz des Mehrwertsteuers
  • PosWUSTBez string -- Bezeichnung des Steuersatzes
  • PosBetragNetto float -- Netto Betrag der Positionen zusammen geführt auf den Satz
  • PosUSTSZiffer string -- Ziffer des Steuerformulares für den Umsatzsteuerbetrag
  • PosWUSTCode string -- Interne Casymir Code
  • PosWUSTKlasse string -- Angaben zum Aufbau der Umsatzsteuererklärung, D Deutsch, C Schweiz, X andere
  • PosUSTUZiffer string -- Ziffer des Steuerformulares für den Umsatzbetrag.
PATCH-Response

Usage:

    {
   "count": 4,
   "success": true,
   "data":    {
      "Adressen":       {
         "KontaktAdr":          {
            "AdrFirma": "Bauer-Lustig",
            "AdrTf1": "0049 6831 555 54",
            "AdrNr": 146,
            "AdrAdresse2": "Hauptstraße 15",
            "AdrAdresse1": "Heilpraktikerin",
            "ISOLandA2": "DE",
            "EmailAdress": "uzuwe@d",
            "OrtLand": "D",
            "OrtName": "Schwalbach",
            "AdrVorname": "Frau Dipl. Ing.",
            "AdrName": "Lelia",
            "OrtPLZ": "66773"
         },
         "LiefAdr":          {
            "AdrFirma": "Bauer-Lustig",
            "AdrTf1": "0049 6831 555 54",
            "AdrNr": 146,
            "AdrAdresse2": "Hauptstraße 15",
            "AdrAdresse1": "Heilpraktikerin",
            "ISOLandA2": "DE",
            "EmailAdress": "uzuwe@d",
            "OrtLand": "D",
            "OrtName": "Schwalbach",
            "AdrVorname": "Frau Dipl. Ing.",
            "AdrName": "Lelia",
            "OrtPLZ": "66773"
         },
         "RechAdr":          {
            "AdrFirma": "Bauer-Lustig",
            "AdrTf1": "0049 6831 555 54",
            "AdrNr": 146,
            "AdrAdresse2": "Hauptstraße 15",
            "AdrAdresse1": "Heilpraktikerin",
            "ISOLandA2": "DE",
            "EmailAdress": "uzuwe@d",
            "OrtLand": "D",
            "OrtName": "Schwalbach",
            "AdrVorname": "Frau Dipl. Ing.",
            "AdrName": "Lelia",
            "OrtPLZ": "66773"
         }
      },
      "Positionen":       [
                  {
            "WUSTSatz": 19,
            "PosAnzBest": 1,
            "PosPreisBasis": 1,
            "VPEinheit": "gf100ml",
            "VisPosNr": 1,
            "PosBez": "Sepanol® KM",
            "VPEPreisEinzel": 2.65,
            "VPEAnzBest": 10,
            "ArtNr": "P201",
            "PosPreisEinzel": 26.5,
            "PosPreisTotal": 26.5,
            "PosNr": 1
         },
                  {
            "PosAnzBest": 5,
            "PosPreisBasis": 1,
            "VPEinheit": "",
            "VisPosNr": 2,
            "PosBez": "Zuckerlikör 100 ml Flasche",
            "WUSTSatz": 19,
            "ArtNr": "C213",
            "PosPreisEinzel": 8.7,
            "PosPreisTotal": 43.5,
            "PosNr": 2
         }
      ],
      "OffertNr": "10214",
      "GrundDaten":       {
         "StaoNr": 1,
         "KundNr": "100075",
         "AuftKomment": "",
         "Template": false,
         "KundBedBez": "Fällig innerhalb 14 Tagen ohne Abzug",
         "AuftBrutto": 261.8,
         "KundBedTyp": 2,
         "AuftBestellTUTC": "2022-08-26T00:00:00",
         "AuftLieferTUTC": "2023-08-26T13:30:00",
         "AuftLiefKost": 150,
         "AuftBestellRef": "",
         "AuftWUST": 41.8,
         "WaehrAbk": "CHF",
         "AuftNetto": 220
      }
   }
}
generated by LDoc 1.4.6 Last updated 2024-11-23 10:47:21