diff --git a/README.md b/README.md index 16ee56f1..43f62b54 100644 --- a/README.md +++ b/README.md @@ -84,3 +84,35 @@ In case you've a question, find a bug, or otherwise need support, use our [commu ## License Copyright (c) 2021 SAP SE or an SAP affiliate company. All rights reserved. This file is licensed under the Apache Software License, version 2.0 except as noted otherwise in the [LICENSE](LICENSE.txt) file. + +# Suppliers - in progress for Messaging & Service Consumption - + +## TODOs + +1. Fix issues when running in same process +2. Automated tests + +## Usage + +1. Run: + + ``` + CDS_ENV=local-hybrid cds mock API_BUSINESS_PARTNER -p 5001 + ``` + +2. Wait until startup is completed +3. Run in a 2nd terminal: + + ``` + CDS_ENV=local-hybrid cds serve all --with-mocks --in-memory + ``` + +4. Now, you can issues the requests listed in `suppliers/requests.http` + +## Request Sequence + +* TODO +## URLs + +* Get books with their replicated supplier: http://localhost:4004/browse/Books?$expand=supplier +* Get remote suppliers: http://localhost:4004/admin/Suppliers?$top=11 \ No newline at end of file diff --git a/bookshop/srv/cat-service.cds b/bookshop/srv/cat-service.cds index 4cc44dff..e1eb8ad5 100644 --- a/bookshop/srv/cat-service.cds +++ b/bookshop/srv/cat-service.cds @@ -2,8 +2,9 @@ using { sap.capire.bookshop as my } from '../db/schema'; service CatalogService @(path:'/browse') { /** For displaying lists of Books */ - @readonly entity ListOfBooks as projection on Books - excluding { descr }; + @readonly entity ListOfBooks as projection on Books { + ID, title, author, genre, price, currency + } /** For display in details pages */ @readonly entity Books as projection on my.Books { *, diff --git a/fiori/.env b/fiori/.env index 36644fa6..8c601148 100644 --- a/fiori/.env +++ b/fiori/.env @@ -1,2 +1,2 @@ -# cds.requires.messaging.kind = file-based-messaging +cds.requires.messaging.kind = file-based-messaging PORT = 4004 \ No newline at end of file diff --git a/fiori/app/bookshop.html b/fiori/app/bookshop.html deleted file mode 100644 index e7c07e25..00000000 --- a/fiori/app/bookshop.html +++ /dev/null @@ -1,3 +0,0 @@ - - - diff --git a/fiori/app/reviews.html b/fiori/app/reviews.html deleted file mode 100644 index 75af8860..00000000 --- a/fiori/app/reviews.html +++ /dev/null @@ -1,3 +0,0 @@ - - - diff --git a/fiori/package.json b/fiori/package.json index 2e4e62cf..76f51da1 100644 --- a/fiori/package.json +++ b/fiori/package.json @@ -3,10 +3,11 @@ "version": "1.0.0", "dependencies": { "@capire/bookshop": "*", - "@capire/reviews": "*", - "@capire/orders": "*", "@capire/common": "*", - "@sap/cds": "^5", + "@capire/orders": "*", + "@capire/reviews": "*", + "@capire/suppliers": "*", + "@sap/cds": ">=5", "express": "^4.17.1", "passport": "^0.4.1" }, @@ -19,6 +20,10 @@ "deploy-format": "hdbtable" }, "requires": { + "API_BUSINESS_PARTNER": { + "kind": "odata", + "model": "@capire/suppliers" + }, "auth": { "strategy": "dummy" }, diff --git a/fiori/server.js b/fiori/server.js index 0a7f34ed..29e3652a 100644 --- a/fiori/server.js +++ b/fiori/server.js @@ -2,22 +2,15 @@ const cds = require ('@sap/cds') module.exports = cds.server cds.once('bootstrap',(app)=>{ - app.use ('/orders/webapp', _from('@capire/orders/app/orders/webapp/manifest.json')) - app.use ('/bookshop', _from('@capire/bookshop/app/vue/index.html')) - app.use ('/reviews', _from('@capire/reviews/app/vue/index.html')) + app.serve ('/orders/webapp').from('@capire/orders','app/orders/webapp') + app.serve ('/bookshop').from('@capire/bookshop','app/vue') + app.serve ('/reviews').from('@capire/reviews','app/vue') }) cds.once('served', require('./srv/mashup')) +cds.once('served', require('@capire/suppliers/srv/mashup')) // Swagger UI - see https://cap.cloud.sap/docs/advanced/openapi if (process.env.NODE_ENV !== 'production') { - const cds_swagger = require ('cds-swagger-ui-express') - cds.once ('bootstrap', app => app.use (cds_swagger()) ) + cds.once ('bootstrap', app => app.use (require ('cds-swagger-ui-express')()) ) } - - -// ----------------------------------------------------------------------- -// Helper for serving static content from npm-installed packages -const {static} = require('express') -const {dirname} = require('path') -const _from = target => static (dirname (require.resolve(target))) diff --git a/fiori/srv/mashup.cds b/fiori/srv/mashup.cds index 97f21771..c62c37bd 100644 --- a/fiori/srv/mashup.cds +++ b/fiori/srv/mashup.cds @@ -3,17 +3,17 @@ // Mashing up imported models... // -using { sap.capire.bookshop.Books } from '@capire/bookshop'; - // // Extend Books with access to Reviews and average ratings // +using { CatalogService.ListOfBooks, sap.capire.bookshop.Books } from '@capire/bookshop'; using { ReviewsService.Reviews } from '@capire/reviews'; extend Books with { reviews : Composition of many Reviews on reviews.subject = $self.ID; - rating : Decimal; + rating : Reviews:rating; } +extend projection ListOfBooks with { rating } // // Extend Orders with Books as Products diff --git a/package.json b/package.json index d796f30b..0eaae4e6 100644 --- a/package.json +++ b/package.json @@ -12,6 +12,7 @@ "@capire/media": "./media", "@capire/orders": "./orders", "@capire/reviews": "./reviews", + "@capire/suppliers": "./suppliers", "@sap/cds": "^5", "express": "^4" }, diff --git a/reviews/srv/reviews-service.cds b/reviews/srv/reviews-service.cds index 6e026b99..6fe6daa7 100644 --- a/reviews/srv/reviews-service.cds +++ b/reviews/srv/reviews-service.cds @@ -8,9 +8,9 @@ service ReviewsService { action unlike (review: type of Reviews:ID); // Async API - event reviewed : { - subject: type of Reviews:subject; - rating: Decimal(2,1) + event reviewed : projection on Reviews { + subject, //> recieved new reviews + rating //> new avg rating } // Input validation diff --git a/reviews/test/bookshop/.env b/reviews/test/bookshop/.env new file mode 100644 index 00000000..8c601148 --- /dev/null +++ b/reviews/test/bookshop/.env @@ -0,0 +1,2 @@ +cds.requires.messaging.kind = file-based-messaging +PORT = 4004 \ No newline at end of file diff --git a/reviews/test/bookshop/package.json b/reviews/test/bookshop/package.json new file mode 100644 index 00000000..f2b47008 --- /dev/null +++ b/reviews/test/bookshop/package.json @@ -0,0 +1,19 @@ +{ + "name": "@capire/fiori", + "version": "1.0.0", + "dependencies": { + "@capire/bookshop": "*", + "@capire/reviews": "*", + "@sap/cds": "^5", + "express": "^4.17.1" + }, + "cds": { + "requires": { + "auth": { "strategy": "dummy" }, + "ReviewsService": { + "kind": "odata", + "model": "@capire/reviews" + } + } + } +} diff --git a/reviews/test/bookshop/server.js b/reviews/test/bookshop/server.js new file mode 100644 index 00000000..70193950 --- /dev/null +++ b/reviews/test/bookshop/server.js @@ -0,0 +1,20 @@ +const cds = require ('@sap/cds') + +cds.once('bootstrap',(app)=>{ + // Delegate to imported apps (reviews only when mocked) + app.serve ('/bookshop').from ('@capire/bookshop','app/vue') + app.serve ('/reviews',).from ('@capire/reviews','app/vue') +}) + +cds.once('served', async ()=>{ + // Update Books' average ratings when ReviewsService signals updated reviews + const ReviewsService = await cds.connect.to ('ReviewsService') + ReviewsService.on ('reviewed', (msg) => { + console.debug ('> received:', msg.event, msg.data) + const { subject, rating } = msg.data + return UPDATE('Books',subject).with({rating}) + }) + +}) + +module.exports = cds.server diff --git a/reviews/test/bookshop/services.cds b/reviews/test/bookshop/services.cds new file mode 100644 index 00000000..9470f6cd --- /dev/null +++ b/reviews/test/bookshop/services.cds @@ -0,0 +1,11 @@ +namespace sap.capire.bookshop; //> allows UPDATE('Books')... +// +// Extend Books with access to Reviews and average ratings +// +using { CatalogService.ListOfBooks, sap.capire.bookshop.Books } from '@capire/bookshop'; +using { ReviewsService.Reviews } from '@capire/reviews'; +extend Books with { + reviews : Composition of many Reviews on reviews.subject = $self.ID; + rating : Reviews:rating; +} +extend projection ListOfBooks with { rating } diff --git a/samples.md b/samples.md index e6c8b066..8ef25fd2 100644 --- a/samples.md +++ b/samples.md @@ -50,14 +50,22 @@ Each sub directory essentially is an individual npm package arranged in an [all- - Late-cut Micro Services - As well as managed data, input validations, and authorization +## [@capire/suppliers](suppliers) + +- Shows how to integrate remote services, in this case the BusinessPartner service from SAP S/4HANA. +- Extending [@capire/bookshop](bookshop) with suppliers from SAP S/4HANA +- Providing that as a pre-built integration & extension package +- Used in [@capire/fiori](fiori) + ## [@capire/fiori](fiori) - A [composite app, reusing and combining](https://cap.cloud.sap/docs/guides/verticalize) these packages: - [@capire/bookshop](bookshop) - - [@capire/reviews](reviews) - - [@capire/orders](orders) - [@capire/common](common) + - [@capire/orders](orders) + - [@capire/reviews](reviews) + - [@capire/suppliers](suppliers) - [Adds an SAP Fiori elements application](https://cap.cloud.sap/docs/guides/fiori/) to bookshop, thereby introducing to: - [OData Annotations](https://cap.cloud.sap/docs/guides/fiori#adding-odata-annotations) in `.cds` files - Support for [Fiori Draft](https://cap.cloud.sap/docs/guides/fiori#draft) diff --git a/suppliers/.env b/suppliers/.env new file mode 100644 index 00000000..9d7dc2db --- /dev/null +++ b/suppliers/.env @@ -0,0 +1 @@ +PORT = 4006 diff --git a/suppliers/app/_i18n/i18n.properties b/suppliers/app/_i18n/i18n.properties new file mode 100644 index 00000000..05cd38b5 --- /dev/null +++ b/suppliers/app/_i18n/i18n.properties @@ -0,0 +1,31 @@ +Books = Books +Book = Book +ID = ID +Title = Title +Author = Author +AuthorID = Author ID +Stock = Stock +Name = Name +AuthorName = Author's Name +DateOfBirth = Date of Birth +DateOfDeath = Date of Death +PlaceOfBirth = Place of Birth +PlaceOfDeath = Place of Death +Age = Age +Authors = Authors +Order = Order +Orders = Orders +Price = Price + +Genre = Genre +Genres = Genres +SubGenres = Sub Genres + +NumCode = Numeric Code +MinorUnit = Minor Unit +Exponent = Exponent + +Supplier = Supplier +SupplierName = Supplier Name +Id = Id +Name = Name \ No newline at end of file diff --git a/suppliers/app/_i18n/i18n_de.properties b/suppliers/app/_i18n/i18n_de.properties new file mode 100644 index 00000000..ee3b52f1 --- /dev/null +++ b/suppliers/app/_i18n/i18n_de.properties @@ -0,0 +1,18 @@ +Books = Bücher +Book = Buch +ID = ID +Title = Titel +Authors = Autoren +Author = Autor +AuthorID = ID des Autors +AuthorName = Name des Autors +Age = Alter +Name = Name +Stock = Bestand +Order = Bestellung +Orders = Bestellungen +Price = Preis +Supplier = Lieferant +SupplierName = Lieferantenname +Id = Id +Name = Name \ No newline at end of file diff --git a/suppliers/app/admin-fiori.html b/suppliers/app/admin-fiori.html new file mode 100644 index 00000000..6c229e6b --- /dev/null +++ b/suppliers/app/admin-fiori.html @@ -0,0 +1,55 @@ + + + + + + + + Bookshop + + + + + + + + + + \ No newline at end of file diff --git a/suppliers/app/admin/fiori-service.cds b/suppliers/app/admin/fiori-service.cds new file mode 100644 index 00000000..97322697 --- /dev/null +++ b/suppliers/app/admin/fiori-service.cds @@ -0,0 +1,105 @@ +//using { AdminService } from '../../db/schema'; + +//////////////////////////////////////////////////////////////////////////// +// +// Books Object Page +// + +annotate AdminService.Books with @( + UI: { + Facets: [ + {$Type: 'UI.ReferenceFacet', Label: '{i18n>General}', Target: '@UI.FieldGroup#General'}, + {$Type: 'UI.ReferenceFacet', Label: '{i18n>Translations}', Target: 'texts/@UI.LineItem'}, + {$Type: 'UI.ReferenceFacet', Label: '{i18n>Details}', Target: '@UI.FieldGroup#Details'}, + {$Type: 'UI.ReferenceFacet', Label: '{i18n>Supplier}', Target: '@UI.FieldGroup#Supplier'}, + {$Type: 'UI.ReferenceFacet', Label: '{i18n>Admin}', Target: '@UI.FieldGroup#Admin'}, + ], + FieldGroup#General: { + Data: [ + {Value: title}, + {Value: author_ID}, + {Value: genre_ID}, + {Value: descr}, + ] + }, + FieldGroup#Details: { + Data: [ + {Value: stock}, + {Value: price}, + {Value: currency_code, Label: '{i18n>Currency}'}, + ] + }, + FieldGroup#Supplier: { + Data: [ + {Value: supplier_ID, Label: '{i18n>Id}'}, + {Value: supplier.name, Label: '{i18n>Name}'} + ] + }, + FieldGroup#Admin: { + Data: [ + {Value: createdBy}, + {Value: createdAt}, + {Value: modifiedBy}, + {Value: modifiedAt} + ] + } + } +); + +annotate AdminService.Authors with @( + UI: { + HeaderInfo: { + Description: {Value: lifetime} + }, + Facets: [ + {$Type: 'UI.ReferenceFacet', Label: '{i18n>Details}', Target: '@UI.FieldGroup#Details'}, + {$Type: 'UI.ReferenceFacet', Label: '{i18n>Books}', Target: 'books/@UI.LineItem'}, + ], + FieldGroup#Details: { + Data: [ + {Value: placeOfBirth}, + {Value: placeOfDeath}, + {Value: dateOfBirth}, + {Value: dateOfDeath}, + {Value: age, Label: '{i18n>Age}'}, + ] + }, + } +); + + + +//////////////////////////////////////////////////////////// +// +// Draft for Localized Data +// + +annotate sap.capire.bookshop.Books with @fiori.draft.enabled; +annotate AdminService.Books with @odata.draft.enabled; + +annotate AdminService.Books.texts with @( + UI: { + Identification: [{Value:title}], + SelectionFields: [ locale, title ], + LineItem: [ + {Value: locale, Label: 'Locale'}, + {Value: title, Label: 'Title'}, + {Value: descr, Label: 'Description'} + ] + } +); + +// Add Value Help for Locales +annotate AdminService.Books.texts { + locale @ValueList:{entity:'Languages',type:#fixed} +} +// In addition we need to expose Languages through AdminService +using { sap } from '@sap/cds/common'; +extend service AdminService { + entity Languages as projection on sap.common.Languages; +} + +annotate AdminService.Suppliers with + @(Capabilities.SearchRestrictions : { + Searchable : false +}); \ No newline at end of file diff --git a/suppliers/app/admin/webapp/Component.js b/suppliers/app/admin/webapp/Component.js new file mode 100644 index 00000000..c3137017 --- /dev/null +++ b/suppliers/app/admin/webapp/Component.js @@ -0,0 +1,8 @@ +sap.ui.define(["sap/fe/core/AppComponent"], function(AppComponent) { + "use strict"; + return AppComponent.extend("admin.Component", { + metadata: { manifest: "json" } + }); +}); + +/* eslint no-undef:0 */ \ No newline at end of file diff --git a/suppliers/app/admin/webapp/i18n/i18n.properties b/suppliers/app/admin/webapp/i18n/i18n.properties new file mode 100644 index 00000000..28b03dff --- /dev/null +++ b/suppliers/app/admin/webapp/i18n/i18n.properties @@ -0,0 +1,11 @@ +# This is the resource bundle of itelo +# __ldi.translation.uuid=c3431418-9caf-11e8-98d0-529269fb1459 + +# JCI app descriptor contains lower case TITLE +appTitle=Bookshop Sample + +# JCI app descriptor contains lower case DESCRIPTION +appSubTitle=CAP Sample Application + +# JCI app descriptor contains lower case DESCRIPTION +appDescription=CDS Sample Service diff --git a/suppliers/app/admin/webapp/manifest.json b/suppliers/app/admin/webapp/manifest.json new file mode 100644 index 00000000..25047c29 --- /dev/null +++ b/suppliers/app/admin/webapp/manifest.json @@ -0,0 +1,128 @@ +{ + "_version": "1.8.0", + "sap.app": { + "id": "admin", + "type": "application", + "title": "Manage Books", + "description": "Sample Application", + "i18n": "i18n/i18n.properties", + "dataSources": { + "AdminService": { + "uri": "/admin/", + "type": "OData", + "settings": { + "odataVersion": "4.0" + } + } + }, + "-sourceTemplate": { + "id": "ui5template.basicSAPUI5ApplicationProject", + "-id": "ui5template.smartTemplate", + "-version": "1.40.12" + } + }, + "sap.ui5": { + "dependencies": { + "libs": { + "sap.fe.templates": {} + } + }, + "models": { + "i18n": { + "type": "sap.ui.model.resource.ResourceModel", + "uri": "i18n/i18n.properties" + }, + "": { + "dataSource": "AdminService", + "settings": { + "synchronizationMode": "None", + "operationMode": "Server", + "autoExpandSelect" : true, + "earlyRequests": true, + "groupProperties": { + "default": { + "submit": "Auto" + } + } + } + } + }, + "routing": { + "routes": [ + { + "pattern": ":?query:", + "name": "BooksList", + "target": "BooksList" + }, + { + "pattern": "Books({key}):?query:", + "name": "BooksDetails", + "target": "BooksDetails" + }, + { + "pattern": "Books({key}/author({key2}):?query:", + "name": "AuthorsDetails", + "target": "AuthorsDetails" + } + ], + "targets": { + "BooksList": { + "type": "Component", + "id": "BooksList", + "name": "sap.fe.templates.ListReport", + "options": { + "settings" : { + "entitySet" : "Books", + "navigation" : { + "Books" : { + "detail" : { + "route" : "BooksDetails" + } + } + } + } + } + }, + "BooksDetails": { + "type": "Component", + "id": "BooksDetailsList", + "name": "sap.fe.templates.ObjectPage", + "options": { + "settings" : { + "entitySet" : "Books", + "navigation" : { + "Authors" : { + "detail" : { + "route" : "AuthorsDetails" + } + } + } + } + } + }, + "AuthorsDetails": { + "type": "Component", + "id": "AuthorsDetailsList", + "name": "sap.fe.templates.ObjectPage", + "options": { + "settings" : { + "entitySet" : "Authors" + } + } + } + } + }, + "contentDensities": { + "compact": true, + "cozy": true + } + }, + "sap.ui": { + "technology": "UI5", + "fullWidth": false + }, + "sap.fiori": { + "registrationIds": [], + "archeType": "transactional" + } +} \ No newline at end of file diff --git a/suppliers/app/common.cds b/suppliers/app/common.cds new file mode 100644 index 00000000..0850e010 --- /dev/null +++ b/suppliers/app/common.cds @@ -0,0 +1,265 @@ +/* + Common Annotations shared by all apps +*/ + +using { sap.capire.bookshop as my } from '@capire/bookshop'; +using { sap.common } from '@capire/common'; + +//////////////////////////////////////////////////////////////////////////// +// +// Books Lists +// +annotate my.Books with @( + Common.SemanticKey: [title], + UI: { + Identification: [{Value:title}], + SelectionFields: [ ID, author_ID, price, currency_code, supplier.ID, supplier.name ], + LineItem: [ + {Value: ID}, + {Value: title}, + {Value: author.name, Label:'{i18n>Author}'}, + {Value: genre.name}, + {Value: stock}, + {Value: price}, + {Value: currency.symbol, Label:' '}, + {Value: supplier.ID}, + {Value: supplier.name} + ] + } +) { + author @ValueList.entity:'Authors'; +}; + +//////////////////////////////////////////////////////////////////////////// +// +// Books Details +// +annotate my.Books with @( + UI: { + HeaderInfo: { + TypeName: '{i18n>Book}', + TypeNamePlural: '{i18n>Books}', + Title: {Value: title}, + Description: {Value: author.name} + }, + } +); + + + +//////////////////////////////////////////////////////////////////////////// +// +// Books Elements +// +annotate my.Books with { + ID @title:'{i18n>ID}' @UI.HiddenFilter; + title @title:'{i18n>Title}'; + genre @title:'{i18n>Genre}' @Common: { Text: genre.name, TextArrangement: #TextOnly }; + author @title:'{i18n>Author}' @Common: { Text: author.name, TextArrangement: #TextOnly }; + price @title:'{i18n>Price}' @Measures.ISOCurrency: currency_code; + stock @title:'{i18n>Stock}'; + descr @UI.MultiLineText; + supplier_ID @title:'{i18n>Supplier}'; +} + +annotate my.Suppliers with { + name @title:'{i18n>SupplierName}'; + ID @title:'{i18n>Supplier}'; +} + +//////////////////////////////////////////////////////////////////////////// +// +// Genres List +// +annotate my.Genres with @( + Common.SemanticKey: [name], + UI: { + SelectionFields: [ name ], + LineItem:[ + {Value: name}, + {Value: parent.name, Label: 'Main Genre'}, + ], + } +); + +//////////////////////////////////////////////////////////////////////////// +// +// Genre Details +// +annotate my.Genres with @( + UI: { + Identification: [{Value:name}], + HeaderInfo: { + TypeName: '{i18n>Genre}', + TypeNamePlural: '{i18n>Genres}', + Title: {Value: name}, + Description: {Value: ID} + }, + Facets: [ + {$Type: 'UI.ReferenceFacet', Label: '{i18n>SubGenres}', Target: 'children/@UI.LineItem'}, + ], + } +); + +//////////////////////////////////////////////////////////////////////////// +// +// Genres Elements +// +annotate my.Genres with { + ID @title: '{i18n>ID}'; + name @title: '{i18n>Genre}'; +} + +//////////////////////////////////////////////////////////////////////////// +// +// Authors List +// +annotate my.Authors with @( + Common.SemanticKey: [name], + UI: { + Identification: [{Value:name}], + SelectionFields: [ name ], + LineItem:[ + {Value: ID}, + {Value: name}, + {Value: dateOfBirth}, + {Value: dateOfDeath}, + {Value: placeOfBirth}, + {Value: placeOfDeath}, + ], + } +); + +//////////////////////////////////////////////////////////////////////////// +// +// Author Details +// +annotate my.Authors with @( + UI: { + HeaderInfo: { + TypeName: '{i18n>Author}', + TypeNamePlural: '{i18n>Authors}', + Title: {Value: name}, + Description: {Value: dateOfBirth} + }, + Facets: [ + {$Type: 'UI.ReferenceFacet', Target: 'books/@UI.LineItem'}, + ], + } +); + + +//////////////////////////////////////////////////////////////////////////// +// +// Authors Elements +// +annotate my.Authors with { + ID @title:'{i18n>ID}' @UI.HiddenFilter; + name @title:'{i18n>Name}'; + dateOfBirth @title:'{i18n>DateOfBirth}'; + dateOfDeath @title:'{i18n>DateOfDeath}'; + placeOfBirth @title:'{i18n>PlaceOfBirth}'; + placeOfDeath @title:'{i18n>PlaceOfDeath}'; +} + +//////////////////////////////////////////////////////////////////////////// +// +// Languages List +// +annotate common.Languages with @( + Common.SemanticKey: [code], + Identification: [{Value:code}], + UI: { + SelectionFields: [ name, descr ], + LineItem:[ + {Value: code}, + {Value: name}, + ], + } +); + +//////////////////////////////////////////////////////////////////////////// +// +// Language Details +// +annotate common.Languages with @( + UI: { + HeaderInfo: { + TypeName: '{i18n>Language}', + TypeNamePlural: '{i18n>Languages}', + Title: {Value: name}, + Description: {Value: descr} + }, + Facets: [ + {$Type: 'UI.ReferenceFacet', Label: '{i18n>Details}', Target: '@UI.FieldGroup#Details'}, + ], + FieldGroup#Details: { + Data: [ + {Value: code}, + {Value: name}, + {Value: descr} + ] + }, + } +); + +//////////////////////////////////////////////////////////////////////////// +// +// Currencies List +// +annotate common.Currencies with @( + Common.SemanticKey: [code], + Identification: [{Value:code}], + UI: { + SelectionFields: [ name, descr ], + LineItem:[ + {Value: descr}, + {Value: symbol}, + {Value: code}, + ], + } +); + +//////////////////////////////////////////////////////////////////////////// +// +// Currency Details +// +annotate common.Currencies with @( + UI: { + HeaderInfo: { + TypeName: '{i18n>Currency}', + TypeNamePlural: '{i18n>Currencies}', + Title: {Value: descr}, + Description: {Value: code} + }, + Facets: [ + {$Type: 'UI.ReferenceFacet', Label: '{i18n>Details}', Target: '@UI.FieldGroup#Details'}, + {$Type: 'UI.ReferenceFacet', Label: '{i18n>Extended}', Target: '@UI.FieldGroup#Extended'}, + ], + FieldGroup#Details: { + Data: [ + {Value: name}, + {Value: symbol}, + {Value: code}, + {Value: descr} + ] + }, + FieldGroup#Extended: { + Data: [ + {Value: numcode}, + {Value: minor}, + {Value: exponent} + ] + }, + } +); + +//////////////////////////////////////////////////////////////////////////// +// +// Currencies Elements +// +annotate common.Currencies with { + numcode @title:'{i18n>NumCode}'; + minor @title:'{i18n>MinorUnit}'; + exponent @title:'{i18n>Exponent}'; +} diff --git a/suppliers/app/services.cds b/suppliers/app/services.cds new file mode 100644 index 00000000..92fc127e --- /dev/null +++ b/suppliers/app/services.cds @@ -0,0 +1,12 @@ +/* + This model controls what gets served to Fiori frontends... +*/ + +using from './admin/fiori-service'; +//using from './browse/fiori-service'; +using from './common'; + +using from '@capire/common'; + +// only works in case of embedded orders service +using from '@capire/orders/app/orders/fiori-service'; diff --git a/suppliers/index.cds b/suppliers/index.cds new file mode 100644 index 00000000..fe4a1f04 --- /dev/null +++ b/suppliers/index.cds @@ -0,0 +1 @@ +using from './srv/mashup'; \ No newline at end of file diff --git a/suppliers/model.drawio b/suppliers/model.drawio new file mode 100644 index 00000000..8e519f67 --- /dev/null +++ b/suppliers/model.drawio @@ -0,0 +1 @@ +7Z1bc6M2GIZ/TabthXdAEpK4zGbTwzSdbutOu3u1g0G2mWBwAcdJf31FQNhI2NY6BuSWm10ksDDo4TvpxbmBd6vnH1JvvfwlCVh0A6zg+QZ+uAHAti3M/yt6Xqoe4pKyZ5GGQdln7Tqm4T+sOlD0bsKAZVVf2ZUnSZSH62ann8Qx8/NGn5emybZ52DyJgkbH2luwxtcoOqa+FzHlsL/CIF+WvRSQXf+PLFwsxZlt7JZ7Vp44uBo4W3pBst3rgvc38C5NkrzcWj3fsai4e8378v2BvfUXS1mc63zA/Xj/2wZtYn/rfdnmf9wv8gxOqlGevGhTXfCUj4B41/tNFsYsyz56aR6z9KYYHUf8TO9nvIEXxZboydZeXFxh/lLdNvz3pris9/Mkzifb6v7c8kPiJF150e4AMdK3fN/vbJXkjG9MWfoU+nwLe6s13xnPsuK/78Tp+Dcszyi+BWicHKTJJg5Ycdk2371dhjmbrj2/2LvlmPK+Zb6Kqt3ZI8v9YqYs3nhiaR7yyb+NwkXM+/KkONqrWhGbF+fzUr/ilJTX7ofxgrforvXweuQHXN2CafXdxN3mZ2HPB6fRruHgjxVLVixPX/gh1QeAWwFWPVEurNrbHZ7ARWXfch9NpwLRqx6JRT32jhq+UYHTDtGXT7/gzfa36f2E/BxMH371pg94golC0UPiF9NsffByb+Zl7BLsIMtqByereHk9Kpjxf/4zqChctNBzEBUM7QYqNkAKKsgmKirQsjtCRRhDLYPzzWhxTMCopqHCiFCsaXEQ6Qoj1W/VrIhJuv2iEHWIJv4dZnJfED61Q7fDJ1ytE34TA755+/Gno2an7m4MezGKBC8+n2V+oU0GQNEOo+guiZL09UxwTn3m+8UoeZo8sr09M+ogx6r3iJgH1N/3bShh0HReVLVINnVVlHBXvguA0yRNN+t1FLI0uzhBJTbZZpaxnG9ssleYrgejOcPtGAXEnVm9YUSxPTRGsAUjaV5YHNwWGQlvzaLEf+T3gndVht3GZfP7sDjx62zszdLBe5Ylm9RnGnznXrpguYZJZYFIiA7Mwf49FvczZZGXh0/NnKntJlfDfUzCON/NJxGBSTWfDoTNIcrLrD61n+NIA3GX0wTDlSa8vA3KQK9zXl/jGzBACga3wSqMd/FFp/GMiLrr042BcGsEg62WQJg4LRGMg7syGI5Cyh3PlaJkcUFWDmZMIyjtoNTVqSOg8JSpV1CwAsqYXBuACgans6K+k2u1DnMwlv0pnicXD2dTxsf2vTIlCjid1xTMBh6j89ZgFvuUzeZdBbNExI7HciLc4py6C2Zpp8Esv1Xpy6f9xuf9xofn6iNl60W0nsP80972573t3UeKhvhE4GXLmpw3RNBEN4IGw0XQkEqJtWxkdCNoCMjxgbqOoN3T7GVLb11s+i9RyI1DCk9bhllpRh5mdYfnPy5ejcuvm5wPw4QJKQlGsjW5wIPuulLWaqlZq/D2+8856Oo5h2oxVvEX75Pk8fJ1j6iKYEYfcZ6PaC149OojxNLCHjtZI7Q47C+SNYtlj7DvKqQw73zLLfg+bbmJpuWupmNivUNAxHvCUCoTItbb9ufDuYy5l1d2XAucZ+4pbBZMbBtIIx2w97uRxIHJfP5axby8T4DgIGtv4awPsHRDgh1YPOVseuCJDfpEi0J6mUiC0vMiiV7Jaivb9lb9n3PnAaw/i3P/yKL1VTlCh9EAtTlCCmYQ464cISRNe4Wx+nD07AjVku8xo9Rf5V+wbXTegokU2FBpyVjX2jjEPj5Qx3kLVOu5PcXS7HmdXNm64VDWwyHNmM0A66FWdxVsvn0Is4L0ZM4n2BohGhgiKsXeBkDUVvc1wgU5mi5IBNRDuCBE8DunMaMEofOckDoUdXp2Q92Wbt+AAr4CFAjE75BlE4hsC1lIUpmcjYULrHeOSwF2qOu4jpRg9Y0Iaqv6DZJFa1sHqInELot2MGnKpCe2ujzXYRZNoLSoc24W7WC50mNeFi0WxMe3CK5m9RraTawmiELl+WgV9Xa3fI1Ai2EaRb3mi3pJ009OuEtTWOpXjokGreuNqt7LcIQsOjRHphb3kG5xTxjVYcLpZrF2QqCkktPW9UoCYZ7yulph0MVCHLW8Nwp7DQxjMFZdT8/KXqSW9EZl7+CkUIucJqVnaS8a35s1khVZXdGaHPWs7XU0qjZD6OIMEUg5wJGmbGhxnaPxiuoorjOBHblW15539Lqi46j567CKJ0Hz6Xzj62u1gyueULMgP4GYNsfQljxJrw+pIxlQrXXactpR86Rhn4bSPFEp+cUilh3OPrWpXUyoiwi4L2enuhA9Ucnh1G9vfPXqELVPjNRxXcTR0K+MipWhZU+SVN0EA6LxquKoezKKIorkWtvwFJmqdnF01S4irh5E+ERltdKkTqO/WvmkjoVEFN+XK9J4c3AYGHRfIB0SBoKOSZ/OB8OFx7RPvUOCTRE/6VsIpAmFQeInJMe35ybUsqrfyIQaq5W+Uf5kdoVfXjds+2XMntVPwuKO6qfrVj9B4VEGE63gUfx0feInIv2ckAEYmap9wrraJ2FSjdA+2eIXAt6qfQJALwS6WHgzSp+uIYSpiyHDKZ/wqHwyEBRF+dQCSs/CJ6xRt/sfi1moHFKKH0AZSsuC20pro5blCrQstvhrIYPV6IlacRtWyiJgPh0+Xr+UBcAzg05ZyaIMZEDdjah1t1HIYvIKIhz8l02FYzUupxUsX84o9aBbAecuCsmyFWWgjlNaolEhG/UGpqhWhrMWGkrJUaRiFDS1SGU4aEyVRhLtsqk7nItRdSTnSiPVkWy3Zy/Tpo00ggRdkeyQJBwXpJxLxXE5Su+EfN0Pd3WXE2vbBhGnXrEa5eycWBaj9JsT8+bubwWXh+/+5DK8/xc= \ No newline at end of file diff --git a/suppliers/package.json b/suppliers/package.json new file mode 100644 index 00000000..8dff8241 --- /dev/null +++ b/suppliers/package.json @@ -0,0 +1,40 @@ +{ + "name": "@capire/suppliers", + "version": "1.0.0", + "description": "Shows integration with SAP S/4HANA, in turn provided as a reusable extension package to bookshop.", + "private": true, + "dependencies": { + "@capire/common": "*", + "@sap/cds": ">=4", + "express": "^4" + }, + "scripts": { + "start": "cds run --in-memory?", + "watch": "cds watch", + "mocked-s4": "cds mock API_BUSINESS_PARTNER" + }, + "cds": { + "requires": { + "API_BUSINESS_PARTNER": { + "kind": "odata", + "model": "srv/external/API_BUSINESS_PARTNER", + "[hybrid]": { + "credentials": { + "destination": "cap-api098", + "path": "/sap/opu/odata/sap/API_BUSINESS_PARTNER" + } + } + }, + "[local-hybrid]": { + "messaging": { + "kind": "file-based-messaging" + } + }, + "[hybrid]": { + "messaging": { + "kind": "enterprise-messaging-shared" + } + } + } + } +} diff --git a/suppliers/requests.http b/suppliers/requests.http new file mode 100644 index 00000000..48ca0c1f --- /dev/null +++ b/suppliers/requests.http @@ -0,0 +1,51 @@ + +@server = http://localhost:4006 +@bpServer = http://localhost:5001 +@authAlice = Authorization: Basic alice: + +### +### Replication on changed Business Partner +### + +### 1. Check supplier name before update ("A Company Making Everything") + +GET {{server}}/admin/Books(299)?$expand=supplier +{{authAlice}} + +### 2. Change Business Partner -> Triggers event that updates supplier replication + +PATCH {{bpServer}}/api-business-partner/A_BusinessPartner('ACME') +Content-Type: application/json + +{ + "BusinessPartnerFullName": "A Company Making Everything *better*" +} + +### 3. Check supplier name after update ("A Company Making Everything *better*") + +GET {{server}}/admin/Books(299)?$expand=supplier +{{authAlice}} + +### +### Replication on new assigned supplier +### + +### 1. No supplier is assigned to "Wuthering Heights" + +GET {{server}}/admin/Books(201)?$expand=supplier +{{authAlice}} + +### 2. Assign supplier ID "PNG" + +PATCH {{server}}/admin/Books(201) +{{authAlice}} +Content-Type: application/json + +{ + "supplier_ID": "PNG" +} + +### 3. Supplier information is replicated + +GET {{server}}/admin/Books(201)?$expand=supplier +{{authAlice}} diff --git a/suppliers/server.js b/suppliers/server.js new file mode 100644 index 00000000..2e8cbb64 --- /dev/null +++ b/suppliers/server.js @@ -0,0 +1,3 @@ +const cds = require ('@sap/cds') +cds.once('served', require('./srv/mashup')) +module.exports = cds.server diff --git a/suppliers/srv/data/sap.capire.bookshop-Books.csv b/suppliers/srv/data/sap.capire.bookshop-Books.csv new file mode 100644 index 00000000..d4e1fc64 --- /dev/null +++ b/suppliers/srv/data/sap.capire.bookshop-Books.csv @@ -0,0 +1,2 @@ +ID;title;descr;author_ID;stock;price;currency_code;genre_ID;supplier_ID; +299;Mobby Dick;"""Moby-Dick""" or """The Whale""" is an 1851 novel by American writer Herman Melville. The book is the sailor Ishmael's narrative of the obsessive quest of Ahab, captain of the whaling ship Pequod, for revenge on Moby Dick, the giant white sperm whale that on the ship's previous voyage bit off Ahab's leg at the knee. A contribution to the literature of the American Renaissance, Moby-Dick was published to mixed reviews, was a commercial failure, and was out of print at the time of the author's death in 1891.;105;99;15.20;GBP;11;ACME \ No newline at end of file diff --git a/suppliers/srv/data/sap.capire.bookshop-Suppliers.csv b/suppliers/srv/data/sap.capire.bookshop-Suppliers.csv new file mode 100644 index 00000000..69c08d69 --- /dev/null +++ b/suppliers/srv/data/sap.capire.bookshop-Suppliers.csv @@ -0,0 +1,3 @@ +ID;name +ACME;A Company Making Everything (replicated) + diff --git a/suppliers/srv/external/API_BUSINESS_PARTNER.csn b/suppliers/srv/external/API_BUSINESS_PARTNER.csn new file mode 100644 index 00000000..411e7c48 --- /dev/null +++ b/suppliers/srv/external/API_BUSINESS_PARTNER.csn @@ -0,0 +1,2425 @@ +{ + "definitions": { + "API_BUSINESS_PARTNER": { + "kind": "service" + }, + "API_BUSINESS_PARTNER.A_AddressEmailAddress": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "AddressID": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "Person": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "OrdinalNumber": { + "key": true, + "type": "cds.String", + "length": 3 + }, + "IsDefaultEmailAddress": { + "type": "cds.Boolean" + }, + "EmailAddress": { + "type": "cds.String", + "length": 241 + }, + "SearchEmailAddress": { + "type": "cds.String", + "length": 20 + } + } + }, + "API_BUSINESS_PARTNER.A_AddressFaxNumber": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "AddressID": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "Person": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "OrdinalNumber": { + "key": true, + "type": "cds.String", + "length": 3 + }, + "IsDefaultFaxNumber": { + "type": "cds.Boolean" + }, + "FaxCountry": { + "type": "cds.String", + "length": 3 + }, + "FaxNumber": { + "type": "cds.String", + "length": 30 + }, + "FaxNumberExtension": { + "type": "cds.String", + "length": 10 + }, + "InternationalFaxNumber": { + "type": "cds.String", + "length": 30 + } + } + }, + "API_BUSINESS_PARTNER.A_AddressHomePageURL": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "AddressID": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "Person": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "OrdinalNumber": { + "key": true, + "type": "cds.String", + "length": 3 + }, + "ValidityStartDate": { + "key": true, + "type": "cds.Date" + }, + "IsDefaultURLAddress": { + "key": true, + "type": "cds.Boolean" + }, + "SearchURLAddress": { + "type": "cds.String", + "length": 50 + }, + "URLFieldLength": { + "type": "cds.Integer" + }, + "WebsiteURL": { + "type": "cds.String", + "length": 2048 + } + } + }, + "API_BUSINESS_PARTNER.A_AddressPhoneNumber": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "AddressID": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "Person": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "OrdinalNumber": { + "key": true, + "type": "cds.String", + "length": 3 + }, + "DestinationLocationCountry": { + "type": "cds.String", + "length": 3 + }, + "IsDefaultPhoneNumber": { + "type": "cds.Boolean" + }, + "PhoneNumber": { + "type": "cds.String", + "length": 30 + }, + "PhoneNumberExtension": { + "type": "cds.String", + "length": 10 + }, + "InternationalPhoneNumber": { + "type": "cds.String", + "length": 30 + }, + "PhoneNumberType": { + "type": "cds.String", + "length": 1 + } + } + }, + "API_BUSINESS_PARTNER.A_BPContactToAddress": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "RelationshipNumber": { + "key": true, + "type": "cds.String", + "length": 12 + }, + "BusinessPartnerCompany": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "BusinessPartnerPerson": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "ValidityEndDate": { + "key": true, + "type": "cds.Date" + }, + "AddressID": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "AddressNumber": { + "type": "cds.String", + "length": 10 + }, + "AdditionalStreetPrefixName": { + "type": "cds.String", + "length": 40 + }, + "AdditionalStreetSuffixName": { + "type": "cds.String", + "length": 40 + }, + "AddressTimeZone": { + "type": "cds.String", + "length": 6 + }, + "CareOfName": { + "type": "cds.String", + "length": 40 + }, + "CityCode": { + "type": "cds.String", + "length": 12 + }, + "CityName": { + "type": "cds.String", + "length": 40 + }, + "CompanyPostalCode": { + "type": "cds.String", + "length": 10 + }, + "Country": { + "type": "cds.String", + "length": 3 + }, + "County": { + "type": "cds.String", + "length": 40 + }, + "DeliveryServiceNumber": { + "type": "cds.String", + "length": 10 + }, + "DeliveryServiceTypeCode": { + "type": "cds.String", + "length": 4 + }, + "District": { + "type": "cds.String", + "length": 40 + }, + "FormOfAddress": { + "type": "cds.String", + "length": 4 + }, + "FullName": { + "type": "cds.String", + "length": 80 + }, + "HomeCityName": { + "type": "cds.String", + "length": 40 + }, + "HouseNumber": { + "type": "cds.String", + "length": 10 + }, + "HouseNumberSupplementText": { + "type": "cds.String", + "length": 10 + }, + "Language": { + "type": "cds.String", + "length": 2 + }, + "POBox": { + "type": "cds.String", + "length": 10 + }, + "POBoxDeviatingCityName": { + "type": "cds.String", + "length": 40 + }, + "POBoxDeviatingCountry": { + "type": "cds.String", + "length": 3 + }, + "POBoxDeviatingRegion": { + "type": "cds.String", + "length": 3 + }, + "POBoxIsWithoutNumber": { + "type": "cds.Boolean" + }, + "POBoxLobbyName": { + "type": "cds.String", + "length": 40 + }, + "POBoxPostalCode": { + "type": "cds.String", + "length": 10 + }, + "Person": { + "type": "cds.String", + "length": 10 + }, + "PostalCode": { + "type": "cds.String", + "length": 10 + }, + "PrfrdCommMediumType": { + "type": "cds.String", + "length": 3 + }, + "Region": { + "type": "cds.String", + "length": 3 + }, + "StreetName": { + "type": "cds.String", + "length": 60 + }, + "StreetPrefixName": { + "type": "cds.String", + "length": 40 + }, + "StreetSuffixName": { + "type": "cds.String", + "length": 40 + }, + "TaxJurisdiction": { + "type": "cds.String", + "length": 15 + }, + "TransportZone": { + "type": "cds.String", + "length": 10 + }, + "to_EmailAddress": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_AddressEmailAddress", + "cardinality": { + "max": "*" + } + }, + "to_FaxNumber": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_AddressFaxNumber", + "cardinality": { + "max": "*" + } + }, + "to_MobilePhoneNumber": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_AddressPhoneNumber", + "cardinality": { + "max": "*" + } + }, + "to_PhoneNumber": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_AddressPhoneNumber", + "cardinality": { + "max": "*" + } + }, + "to_URLAddress": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_AddressHomePageURL", + "cardinality": { + "max": "*" + } + } + } + }, + "API_BUSINESS_PARTNER.A_BPContactToFuncAndDept": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "RelationshipNumber": { + "key": true, + "type": "cds.String", + "length": 12 + }, + "BusinessPartnerCompany": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "BusinessPartnerPerson": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "ValidityEndDate": { + "key": true, + "type": "cds.Date" + }, + "ContactPersonFunction": { + "type": "cds.String", + "length": 4 + }, + "ContactPersonDepartment": { + "type": "cds.String", + "length": 4 + }, + "PhoneNumber": { + "type": "cds.String", + "length": 30 + }, + "PhoneNumberExtension": { + "type": "cds.String", + "length": 10 + }, + "FaxNumber": { + "type": "cds.String", + "length": 30 + }, + "FaxNumberExtension": { + "type": "cds.String", + "length": 10 + }, + "EmailAddress": { + "type": "cds.String", + "length": 241 + }, + "RelationshipCategory": { + "type": "cds.String", + "length": 6 + } + } + }, + "API_BUSINESS_PARTNER.A_BuPaAddressUsage": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "BusinessPartner": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "ValidityEndDate": { + "key": true, + "type": "cds.Timestamp" + }, + "AddressUsage": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "AddressID": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "ValidityStartDate": { + "type": "cds.Timestamp" + }, + "StandardUsage": { + "type": "cds.Boolean" + }, + "AuthorizationGroup": { + "type": "cds.String", + "length": 4 + } + } + }, + "API_BUSINESS_PARTNER.A_BuPaIdentification": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "BusinessPartner": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "BPIdentificationType": { + "key": true, + "type": "cds.String", + "length": 6 + }, + "BPIdentificationNumber": { + "key": true, + "type": "cds.String", + "length": 60 + }, + "BPIdnNmbrIssuingInstitute": { + "type": "cds.String", + "length": 40 + }, + "BPIdentificationEntryDate": { + "type": "cds.Date" + }, + "Country": { + "type": "cds.String", + "length": 3 + }, + "Region": { + "type": "cds.String", + "length": 3 + }, + "ValidityStartDate": { + "type": "cds.Date" + }, + "ValidityEndDate": { + "type": "cds.Date" + }, + "AuthorizationGroup": { + "type": "cds.String", + "length": 4 + } + } + }, + "API_BUSINESS_PARTNER.A_BuPaIndustry": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "IndustrySector": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "IndustrySystemType": { + "key": true, + "type": "cds.String", + "length": 4 + }, + "BusinessPartner": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "IsStandardIndustry": { + "type": "cds.String", + "length": 1 + }, + "IndustryKeyDescription": { + "type": "cds.String", + "length": 100 + } + } + }, + "API_BUSINESS_PARTNER.A_BusinessPartner": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "BusinessPartner": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "Customer": { + "type": "cds.String", + "length": 10 + }, + "Supplier": { + "type": "cds.String", + "length": 10 + }, + "AcademicTitle": { + "type": "cds.String", + "length": 4 + }, + "AuthorizationGroup": { + "type": "cds.String", + "length": 4 + }, + "BusinessPartnerCategory": { + "type": "cds.String", + "length": 1 + }, + "BusinessPartnerFullName": { + "type": "cds.String", + "length": 81 + }, + "BusinessPartnerGrouping": { + "type": "cds.String", + "length": 4 + }, + "BusinessPartnerName": { + "type": "cds.String", + "length": 81 + }, + "BusinessPartnerUUID": { + "type": "cds.UUID" + }, + "CorrespondenceLanguage": { + "type": "cds.String", + "length": 2 + }, + "CreatedByUser": { + "type": "cds.String", + "length": 12 + }, + "CreationDate": { + "type": "cds.Date" + }, + "CreationTime": { + "type": "cds.Time" + }, + "FirstName": { + "type": "cds.String", + "length": 40 + }, + "FormOfAddress": { + "type": "cds.String", + "length": 4 + }, + "Industry": { + "type": "cds.String", + "length": 10 + }, + "InternationalLocationNumber1": { + "type": "cds.String", + "length": 7 + }, + "InternationalLocationNumber2": { + "type": "cds.String", + "length": 5 + }, + "IsFemale": { + "type": "cds.Boolean" + }, + "IsMale": { + "type": "cds.Boolean" + }, + "IsNaturalPerson": { + "type": "cds.String", + "length": 1 + }, + "IsSexUnknown": { + "type": "cds.Boolean" + }, + "Language": { + "type": "cds.String", + "length": 2 + }, + "LastChangeDate": { + "type": "cds.Date" + }, + "LastChangeTime": { + "type": "cds.Time" + }, + "LastChangedByUser": { + "type": "cds.String", + "length": 12 + }, + "LastName": { + "type": "cds.String", + "length": 40 + }, + "LegalForm": { + "type": "cds.String", + "length": 2 + }, + "OrganizationBPName1": { + "type": "cds.String", + "length": 40 + }, + "OrganizationBPName2": { + "type": "cds.String", + "length": 40 + }, + "OrganizationBPName3": { + "type": "cds.String", + "length": 40 + }, + "OrganizationBPName4": { + "type": "cds.String", + "length": 40 + }, + "OrganizationFoundationDate": { + "type": "cds.Date" + }, + "OrganizationLiquidationDate": { + "type": "cds.Date" + }, + "SearchTerm1": { + "type": "cds.String", + "length": 20 + }, + "AdditionalLastName": { + "type": "cds.String", + "length": 40 + }, + "BirthDate": { + "type": "cds.Date" + }, + "BusinessPartnerIsBlocked": { + "type": "cds.Boolean" + }, + "BusinessPartnerType": { + "type": "cds.String", + "length": 4 + }, + "ETag": { + "type": "cds.String", + "length": 26 + }, + "GroupBusinessPartnerName1": { + "type": "cds.String", + "length": 40 + }, + "GroupBusinessPartnerName2": { + "type": "cds.String", + "length": 40 + }, + "IndependentAddressID": { + "type": "cds.String", + "length": 10 + }, + "InternationalLocationNumber3": { + "type": "cds.String", + "length": 1 + }, + "MiddleName": { + "type": "cds.String", + "length": 40 + }, + "NameCountry": { + "type": "cds.String", + "length": 3 + }, + "NameFormat": { + "type": "cds.String", + "length": 2 + }, + "PersonFullName": { + "type": "cds.String", + "length": 80 + }, + "PersonNumber": { + "type": "cds.String", + "length": 10 + }, + "IsMarkedForArchiving": { + "type": "cds.Boolean" + }, + "BusinessPartnerIDByExtSystem": { + "type": "cds.String", + "length": 20 + }, + "TradingPartner": { + "type": "cds.String", + "length": 6 + }, + "to_BuPaIdentification": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_BuPaIdentification", + "cardinality": { + "max": "*" + } + }, + "to_BuPaIndustry": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_BuPaIndustry", + "cardinality": { + "max": "*" + } + }, + "to_BusinessPartnerAddress": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_BusinessPartnerAddress", + "cardinality": { + "max": "*" + } + }, + "to_BusinessPartnerBank": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_BusinessPartnerBank", + "cardinality": { + "max": "*" + } + }, + "to_BusinessPartnerContact": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_BusinessPartnerContact", + "cardinality": { + "max": "*" + } + }, + "to_BusinessPartnerRole": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_BusinessPartnerRole", + "cardinality": { + "max": "*" + } + }, + "to_BusinessPartnerTax": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_BusinessPartnerTaxNumber", + "cardinality": { + "max": "*" + } + }, + "to_Customer": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_Customer" + }, + "to_Supplier": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_Supplier" + } + } + }, + "API_BUSINESS_PARTNER.A_BusinessPartnerAddress": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "BusinessPartner": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "AddressID": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "ValidityStartDate": { + "type": "cds.Timestamp" + }, + "ValidityEndDate": { + "type": "cds.Timestamp" + }, + "AuthorizationGroup": { + "type": "cds.String", + "length": 4 + }, + "AddressUUID": { + "type": "cds.UUID" + }, + "AdditionalStreetPrefixName": { + "type": "cds.String", + "length": 40 + }, + "AdditionalStreetSuffixName": { + "type": "cds.String", + "length": 40 + }, + "AddressTimeZone": { + "type": "cds.String", + "length": 6 + }, + "CareOfName": { + "type": "cds.String", + "length": 40 + }, + "CityCode": { + "type": "cds.String", + "length": 12 + }, + "CityName": { + "type": "cds.String", + "length": 40 + }, + "CompanyPostalCode": { + "type": "cds.String", + "length": 10 + }, + "Country": { + "type": "cds.String", + "length": 3 + }, + "County": { + "type": "cds.String", + "length": 40 + }, + "DeliveryServiceNumber": { + "type": "cds.String", + "length": 10 + }, + "DeliveryServiceTypeCode": { + "type": "cds.String", + "length": 4 + }, + "District": { + "type": "cds.String", + "length": 40 + }, + "FormOfAddress": { + "type": "cds.String", + "length": 4 + }, + "FullName": { + "type": "cds.String", + "length": 80 + }, + "HomeCityName": { + "type": "cds.String", + "length": 40 + }, + "HouseNumber": { + "type": "cds.String", + "length": 10 + }, + "HouseNumberSupplementText": { + "type": "cds.String", + "length": 10 + }, + "Language": { + "type": "cds.String", + "length": 2 + }, + "POBox": { + "type": "cds.String", + "length": 10 + }, + "POBoxDeviatingCityName": { + "type": "cds.String", + "length": 40 + }, + "POBoxDeviatingCountry": { + "type": "cds.String", + "length": 3 + }, + "POBoxDeviatingRegion": { + "type": "cds.String", + "length": 3 + }, + "POBoxIsWithoutNumber": { + "type": "cds.Boolean" + }, + "POBoxLobbyName": { + "type": "cds.String", + "length": 40 + }, + "POBoxPostalCode": { + "type": "cds.String", + "length": 10 + }, + "Person": { + "type": "cds.String", + "length": 10 + }, + "PostalCode": { + "type": "cds.String", + "length": 10 + }, + "PrfrdCommMediumType": { + "type": "cds.String", + "length": 3 + }, + "Region": { + "type": "cds.String", + "length": 3 + }, + "StreetName": { + "type": "cds.String", + "length": 60 + }, + "StreetPrefixName": { + "type": "cds.String", + "length": 40 + }, + "StreetSuffixName": { + "type": "cds.String", + "length": 40 + }, + "TaxJurisdiction": { + "type": "cds.String", + "length": 15 + }, + "TransportZone": { + "type": "cds.String", + "length": 10 + }, + "AddressIDByExternalSystem": { + "type": "cds.String", + "length": 20 + }, + "to_AddressUsage": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_BuPaAddressUsage", + "cardinality": { + "max": "*" + } + }, + "to_EmailAddress": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_AddressEmailAddress", + "cardinality": { + "max": "*" + } + }, + "to_FaxNumber": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_AddressFaxNumber", + "cardinality": { + "max": "*" + } + }, + "to_MobilePhoneNumber": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_AddressPhoneNumber", + "cardinality": { + "max": "*" + } + }, + "to_PhoneNumber": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_AddressPhoneNumber", + "cardinality": { + "max": "*" + } + }, + "to_URLAddress": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_AddressHomePageURL", + "cardinality": { + "max": "*" + } + } + } + }, + "API_BUSINESS_PARTNER.A_BusinessPartnerBank": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "BusinessPartner": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "BankIdentification": { + "key": true, + "type": "cds.String", + "length": 4 + }, + "BankCountryKey": { + "type": "cds.String", + "length": 3 + }, + "BankName": { + "type": "cds.String", + "length": 60 + }, + "BankNumber": { + "type": "cds.String", + "length": 15 + }, + "SWIFTCode": { + "type": "cds.String", + "length": 11 + }, + "BankControlKey": { + "type": "cds.String", + "length": 2 + }, + "BankAccountHolderName": { + "type": "cds.String", + "length": 60 + }, + "BankAccountName": { + "type": "cds.String", + "length": 40 + }, + "ValidityStartDate": { + "type": "cds.Timestamp" + }, + "ValidityEndDate": { + "type": "cds.Timestamp" + }, + "IBAN": { + "type": "cds.String", + "length": 34 + }, + "IBANValidityStartDate": { + "type": "cds.Date" + }, + "BankAccount": { + "type": "cds.String", + "length": 18 + }, + "BankAccountReferenceText": { + "type": "cds.String", + "length": 20 + }, + "CollectionAuthInd": { + "type": "cds.Boolean" + }, + "CityName": { + "type": "cds.String", + "length": 35 + }, + "AuthorizationGroup": { + "type": "cds.String", + "length": 4 + } + } + }, + "API_BUSINESS_PARTNER.A_BusinessPartnerContact": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "RelationshipNumber": { + "key": true, + "type": "cds.String", + "length": 12 + }, + "BusinessPartnerCompany": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "BusinessPartnerPerson": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "ValidityEndDate": { + "key": true, + "type": "cds.Date" + }, + "ValidityStartDate": { + "type": "cds.Date" + }, + "IsStandardRelationship": { + "type": "cds.Boolean" + }, + "RelationshipCategory": { + "type": "cds.String", + "length": 6 + }, + "to_ContactAddress": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_BPContactToAddress", + "cardinality": { + "max": "*" + } + }, + "to_ContactRelationship": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_BPContactToFuncAndDept" + } + } + }, + "API_BUSINESS_PARTNER.A_BusinessPartnerRole": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "BusinessPartner": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "BusinessPartnerRole": { + "key": true, + "type": "cds.String", + "length": 6 + }, + "ValidFrom": { + "type": "cds.Timestamp" + }, + "ValidTo": { + "type": "cds.Timestamp" + }, + "AuthorizationGroup": { + "type": "cds.String", + "length": 4 + } + } + }, + "API_BUSINESS_PARTNER.A_BusinessPartnerTaxNumber": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "BusinessPartner": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "BPTaxType": { + "key": true, + "type": "cds.String", + "length": 4 + }, + "BPTaxNumber": { + "type": "cds.String", + "length": 20 + }, + "BPTaxLongNumber": { + "type": "cds.String", + "length": 60 + }, + "AuthorizationGroup": { + "type": "cds.String", + "length": 4 + } + } + }, + "API_BUSINESS_PARTNER.A_Customer": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "Customer": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "AuthorizationGroup": { + "type": "cds.String", + "length": 4 + }, + "BillingIsBlockedForCustomer": { + "type": "cds.String", + "length": 2 + }, + "CreatedByUser": { + "type": "cds.String", + "length": 12 + }, + "CreationDate": { + "type": "cds.Date" + }, + "CustomerAccountGroup": { + "type": "cds.String", + "length": 4 + }, + "CustomerClassification": { + "type": "cds.String", + "length": 2 + }, + "CustomerFullName": { + "type": "cds.String", + "length": 220 + }, + "CustomerName": { + "type": "cds.String", + "length": 80 + }, + "DeliveryIsBlocked": { + "type": "cds.String", + "length": 2 + }, + "NFPartnerIsNaturalPerson": { + "type": "cds.String", + "length": 1 + }, + "OrderIsBlockedForCustomer": { + "type": "cds.String", + "length": 2 + }, + "PostingIsBlocked": { + "type": "cds.Boolean" + }, + "Supplier": { + "type": "cds.String", + "length": 10 + }, + "CustomerCorporateGroup": { + "type": "cds.String", + "length": 10 + }, + "FiscalAddress": { + "type": "cds.String", + "length": 10 + }, + "Industry": { + "type": "cds.String", + "length": 4 + }, + "IndustryCode1": { + "type": "cds.String", + "length": 10 + }, + "IndustryCode2": { + "type": "cds.String", + "length": 10 + }, + "IndustryCode3": { + "type": "cds.String", + "length": 10 + }, + "IndustryCode4": { + "type": "cds.String", + "length": 10 + }, + "IndustryCode5": { + "type": "cds.String", + "length": 10 + }, + "InternationalLocationNumber1": { + "type": "cds.String", + "length": 7 + }, + "NielsenRegion": { + "type": "cds.String", + "length": 2 + }, + "ResponsibleType": { + "type": "cds.String", + "length": 2 + }, + "TaxNumber1": { + "type": "cds.String", + "length": 16 + }, + "TaxNumber2": { + "type": "cds.String", + "length": 11 + }, + "TaxNumber3": { + "type": "cds.String", + "length": 18 + }, + "TaxNumber4": { + "type": "cds.String", + "length": 18 + }, + "TaxNumber5": { + "type": "cds.String", + "length": 60 + }, + "TaxNumberType": { + "type": "cds.String", + "length": 2 + }, + "VATRegistration": { + "type": "cds.String", + "length": 20 + }, + "DeletionIndicator": { + "type": "cds.Boolean" + }, + "to_CustomerCompany": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_CustomerCompany", + "cardinality": { + "max": "*" + } + }, + "to_CustomerSalesArea": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_CustomerSalesArea", + "cardinality": { + "max": "*" + } + } + } + }, + "API_BUSINESS_PARTNER.A_CustomerCompany": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "Customer": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "CompanyCode": { + "key": true, + "type": "cds.String", + "length": 4 + }, + "APARToleranceGroup": { + "type": "cds.String", + "length": 4 + }, + "AccountByCustomer": { + "type": "cds.String", + "length": 12 + }, + "AccountingClerk": { + "type": "cds.String", + "length": 2 + }, + "AccountingClerkFaxNumber": { + "type": "cds.String", + "length": 31 + }, + "AccountingClerkInternetAddress": { + "type": "cds.String", + "length": 130 + }, + "AccountingClerkPhoneNumber": { + "type": "cds.String", + "length": 30 + }, + "AlternativePayerAccount": { + "type": "cds.String", + "length": 10 + }, + "AuthorizationGroup": { + "type": "cds.String", + "length": 4 + }, + "CollectiveInvoiceVariant": { + "type": "cds.String", + "length": 1 + }, + "CustomerAccountNote": { + "type": "cds.String", + "length": 30 + }, + "CustomerHeadOffice": { + "type": "cds.String", + "length": 10 + }, + "CustomerSupplierClearingIsUsed": { + "type": "cds.Boolean" + }, + "HouseBank": { + "type": "cds.String", + "length": 5 + }, + "InterestCalculationCode": { + "type": "cds.String", + "length": 2 + }, + "InterestCalculationDate": { + "type": "cds.Date" + }, + "IntrstCalcFrequencyInMonths": { + "type": "cds.String", + "length": 2 + }, + "IsToBeLocallyProcessed": { + "type": "cds.Boolean" + }, + "ItemIsToBePaidSeparately": { + "type": "cds.Boolean" + }, + "LayoutSortingRule": { + "type": "cds.String", + "length": 3 + }, + "PaymentBlockingReason": { + "type": "cds.String", + "length": 1 + }, + "PaymentMethodsList": { + "type": "cds.String", + "length": 10 + }, + "PaymentTerms": { + "type": "cds.String", + "length": 4 + }, + "PaytAdviceIsSentbyEDI": { + "type": "cds.Boolean" + }, + "PhysicalInventoryBlockInd": { + "type": "cds.Boolean" + }, + "ReconciliationAccount": { + "type": "cds.String", + "length": 10 + }, + "RecordPaymentHistoryIndicator": { + "type": "cds.Boolean" + }, + "UserAtCustomer": { + "type": "cds.String", + "length": 15 + }, + "DeletionIndicator": { + "type": "cds.Boolean" + }, + "CustomerAccountGroup": { + "type": "cds.String", + "length": 4 + }, + "to_CustomerDunning": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_CustomerDunning", + "cardinality": { + "max": "*" + } + }, + "to_WithHoldingTax": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_CustomerWithHoldingTax", + "cardinality": { + "max": "*" + } + } + } + }, + "API_BUSINESS_PARTNER.A_CustomerDunning": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "Customer": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "CompanyCode": { + "key": true, + "type": "cds.String", + "length": 4 + }, + "DunningArea": { + "key": true, + "type": "cds.String", + "length": 2 + }, + "DunningBlock": { + "type": "cds.String", + "length": 1 + }, + "DunningLevel": { + "type": "cds.String", + "length": 1 + }, + "DunningProcedure": { + "type": "cds.String", + "length": 4 + }, + "DunningRecipient": { + "type": "cds.String", + "length": 10 + }, + "LastDunnedOn": { + "type": "cds.Date" + }, + "LegDunningProcedureOn": { + "type": "cds.Date" + }, + "DunningClerk": { + "type": "cds.String", + "length": 2 + }, + "AuthorizationGroup": { + "type": "cds.String", + "length": 4 + }, + "CustomerAccountGroup": { + "type": "cds.String", + "length": 4 + } + } + }, + "API_BUSINESS_PARTNER.A_CustomerSalesArea": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "Customer": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "SalesOrganization": { + "key": true, + "type": "cds.String", + "length": 4 + }, + "DistributionChannel": { + "key": true, + "type": "cds.String", + "length": 2 + }, + "Division": { + "key": true, + "type": "cds.String", + "length": 2 + }, + "AccountByCustomer": { + "type": "cds.String", + "length": 12 + }, + "AuthorizationGroup": { + "type": "cds.String", + "length": 4 + }, + "BillingIsBlockedForCustomer": { + "type": "cds.String", + "length": 2 + }, + "CompleteDeliveryIsDefined": { + "type": "cds.Boolean" + }, + "Currency": { + "type": "cds.String", + "length": 5 + }, + "CustomerABCClassification": { + "type": "cds.String", + "length": 2 + }, + "CustomerAccountAssignmentGroup": { + "type": "cds.String", + "length": 2 + }, + "CustomerGroup": { + "type": "cds.String", + "length": 2 + }, + "CustomerPaymentTerms": { + "type": "cds.String", + "length": 4 + }, + "CustomerPriceGroup": { + "type": "cds.String", + "length": 2 + }, + "CustomerPricingProcedure": { + "type": "cds.String", + "length": 2 + }, + "DeliveryIsBlockedForCustomer": { + "type": "cds.String", + "length": 2 + }, + "DeliveryPriority": { + "type": "cds.String", + "length": 2 + }, + "IncotermsClassification": { + "type": "cds.String", + "length": 3 + }, + "IncotermsLocation2": { + "type": "cds.String", + "length": 70 + }, + "IncotermsVersion": { + "type": "cds.String", + "length": 4 + }, + "IncotermsLocation1": { + "type": "cds.String", + "length": 70 + }, + "DeletionIndicator": { + "type": "cds.Boolean" + }, + "IncotermsTransferLocation": { + "type": "cds.String", + "length": 28 + }, + "InvoiceDate": { + "type": "cds.String", + "length": 2 + }, + "ItemOrderProbabilityInPercent": { + "type": "cds.String", + "length": 3 + }, + "OrderCombinationIsAllowed": { + "type": "cds.Boolean" + }, + "OrderIsBlockedForCustomer": { + "type": "cds.String", + "length": 2 + }, + "PartialDeliveryIsAllowed": { + "type": "cds.String", + "length": 1 + }, + "PriceListType": { + "type": "cds.String", + "length": 2 + }, + "SalesGroup": { + "type": "cds.String", + "length": 3 + }, + "SalesOffice": { + "type": "cds.String", + "length": 4 + }, + "ShippingCondition": { + "type": "cds.String", + "length": 2 + }, + "SupplyingPlant": { + "type": "cds.String", + "length": 4 + }, + "SalesDistrict": { + "type": "cds.String", + "length": 6 + }, + "CustomerAccountGroup": { + "type": "cds.String", + "length": 4 + }, + "to_PartnerFunction": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_CustSalesPartnerFunc", + "cardinality": { + "max": "*" + } + }, + "to_SalesAreaTax": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_CustomerSalesAreaTax", + "cardinality": { + "max": "*" + } + } + } + }, + "API_BUSINESS_PARTNER.A_CustomerSalesAreaTax": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "Customer": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "SalesOrganization": { + "key": true, + "type": "cds.String", + "length": 4 + }, + "DistributionChannel": { + "key": true, + "type": "cds.String", + "length": 2 + }, + "Division": { + "key": true, + "type": "cds.String", + "length": 2 + }, + "DepartureCountry": { + "key": true, + "type": "cds.String", + "length": 3 + }, + "CustomerTaxCategory": { + "key": true, + "type": "cds.String", + "length": 4 + }, + "CustomerTaxClassification": { + "type": "cds.String", + "length": 1 + } + } + }, + "API_BUSINESS_PARTNER.A_CustomerWithHoldingTax": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "Customer": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "CompanyCode": { + "key": true, + "type": "cds.String", + "length": 4 + }, + "WithholdingTaxType": { + "key": true, + "type": "cds.String", + "length": 2 + }, + "WithholdingTaxCode": { + "type": "cds.String", + "length": 2 + }, + "WithholdingTaxAgent": { + "type": "cds.Boolean" + }, + "ObligationDateBegin": { + "type": "cds.Date" + }, + "ObligationDateEnd": { + "type": "cds.Date" + }, + "WithholdingTaxNumber": { + "type": "cds.String", + "length": 16 + }, + "WithholdingTaxCertificate": { + "type": "cds.String", + "length": 25 + }, + "WithholdingTaxExmptPercent": { + "type": "cds.Decimal", + "precision": 5, + "scale": 2 + }, + "ExemptionDateBegin": { + "type": "cds.Date" + }, + "ExemptionDateEnd": { + "type": "cds.Date" + }, + "ExemptionReason": { + "type": "cds.String", + "length": 2 + }, + "AuthorizationGroup": { + "type": "cds.String", + "length": 4 + } + } + }, + "API_BUSINESS_PARTNER.A_CustSalesPartnerFunc": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "Customer": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "SalesOrganization": { + "key": true, + "type": "cds.String", + "length": 4 + }, + "DistributionChannel": { + "key": true, + "type": "cds.String", + "length": 2 + }, + "Division": { + "key": true, + "type": "cds.String", + "length": 2 + }, + "PartnerCounter": { + "key": true, + "type": "cds.String", + "length": 3 + }, + "PartnerFunction": { + "key": true, + "type": "cds.String", + "length": 2 + }, + "BPCustomerNumber": { + "type": "cds.String", + "length": 10 + }, + "CustomerPartnerDescription": { + "type": "cds.String", + "length": 30 + }, + "DefaultPartner": { + "type": "cds.Boolean" + }, + "AuthorizationGroup": { + "type": "cds.String", + "length": 4 + } + } + }, + "API_BUSINESS_PARTNER.A_Supplier": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "Supplier": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "AlternativePayeeAccountNumber": { + "type": "cds.String", + "length": 10 + }, + "AuthorizationGroup": { + "type": "cds.String", + "length": 4 + }, + "CreatedByUser": { + "type": "cds.String", + "length": 12 + }, + "CreationDate": { + "type": "cds.Date" + }, + "Customer": { + "type": "cds.String", + "length": 10 + }, + "PaymentIsBlockedForSupplier": { + "type": "cds.Boolean" + }, + "PostingIsBlocked": { + "type": "cds.Boolean" + }, + "PurchasingIsBlocked": { + "type": "cds.Boolean" + }, + "SupplierAccountGroup": { + "type": "cds.String", + "length": 4 + }, + "SupplierFullName": { + "type": "cds.String", + "length": 220 + }, + "SupplierName": { + "type": "cds.String", + "length": 80 + }, + "VATRegistration": { + "type": "cds.String", + "length": 20 + }, + "BirthDate": { + "type": "cds.Date" + }, + "ConcatenatedInternationalLocNo": { + "type": "cds.String", + "length": 20 + }, + "DeletionIndicator": { + "type": "cds.Boolean" + }, + "FiscalAddress": { + "type": "cds.String", + "length": 10 + }, + "Industry": { + "type": "cds.String", + "length": 4 + }, + "InternationalLocationNumber1": { + "type": "cds.String", + "length": 7 + }, + "InternationalLocationNumber2": { + "type": "cds.String", + "length": 5 + }, + "InternationalLocationNumber3": { + "type": "cds.String", + "length": 1 + }, + "IsNaturalPerson": { + "type": "cds.String", + "length": 1 + }, + "ResponsibleType": { + "type": "cds.String", + "length": 2 + }, + "SuplrQltyInProcmtCertfnValidTo": { + "type": "cds.Date" + }, + "SuplrQualityManagementSystem": { + "type": "cds.String", + "length": 4 + }, + "SupplierCorporateGroup": { + "type": "cds.String", + "length": 10 + }, + "SupplierProcurementBlock": { + "type": "cds.String", + "length": 2 + }, + "TaxNumber1": { + "type": "cds.String", + "length": 16 + }, + "TaxNumber2": { + "type": "cds.String", + "length": 11 + }, + "TaxNumber3": { + "type": "cds.String", + "length": 18 + }, + "TaxNumber4": { + "type": "cds.String", + "length": 18 + }, + "TaxNumber5": { + "type": "cds.String", + "length": 60 + }, + "TaxNumberResponsible": { + "type": "cds.String", + "length": 18 + }, + "TaxNumberType": { + "type": "cds.String", + "length": 2 + }, + "to_SupplierCompany": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_SupplierCompany", + "cardinality": { + "max": "*" + } + }, + "to_SupplierPurchasingOrg": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_SupplierPurchasingOrg", + "cardinality": { + "max": "*" + } + } + } + }, + "API_BUSINESS_PARTNER.A_SupplierCompany": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "Supplier": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "CompanyCode": { + "key": true, + "type": "cds.String", + "length": 4 + }, + "AuthorizationGroup": { + "type": "cds.String", + "length": 4 + }, + "CompanyCodeName": { + "type": "cds.String", + "length": 25 + }, + "PaymentBlockingReason": { + "type": "cds.String", + "length": 1 + }, + "SupplierIsBlockedForPosting": { + "type": "cds.Boolean" + }, + "AccountingClerk": { + "type": "cds.String", + "length": 2 + }, + "AccountingClerkFaxNumber": { + "type": "cds.String", + "length": 31 + }, + "AccountingClerkPhoneNumber": { + "type": "cds.String", + "length": 30 + }, + "SupplierClerk": { + "type": "cds.String", + "length": 15 + }, + "SupplierClerkURL": { + "type": "cds.String", + "length": 130 + }, + "PaymentMethodsList": { + "type": "cds.String", + "length": 10 + }, + "PaymentTerms": { + "type": "cds.String", + "length": 4 + }, + "ClearCustomerSupplier": { + "type": "cds.Boolean" + }, + "IsToBeLocallyProcessed": { + "type": "cds.Boolean" + }, + "ItemIsToBePaidSeparately": { + "type": "cds.Boolean" + }, + "PaymentIsToBeSentByEDI": { + "type": "cds.Boolean" + }, + "HouseBank": { + "type": "cds.String", + "length": 5 + }, + "CheckPaidDurationInDays": { + "type": "cds.Decimal", + "precision": 3, + "scale": 0 + }, + "BillOfExchLmtAmtInCoCodeCrcy": { + "type": "cds.Decimal", + "precision": 14, + "scale": 3 + }, + "SupplierClerkIDBySupplier": { + "type": "cds.String", + "length": 12 + }, + "ReconciliationAccount": { + "type": "cds.String", + "length": 10 + }, + "InterestCalculationCode": { + "type": "cds.String", + "length": 2 + }, + "InterestCalculationDate": { + "type": "cds.Date" + }, + "IntrstCalcFrequencyInMonths": { + "type": "cds.String", + "length": 2 + }, + "SupplierHeadOffice": { + "type": "cds.String", + "length": 10 + }, + "AlternativePayee": { + "type": "cds.String", + "length": 10 + }, + "LayoutSortingRule": { + "type": "cds.String", + "length": 3 + }, + "APARToleranceGroup": { + "type": "cds.String", + "length": 4 + }, + "SupplierCertificationDate": { + "type": "cds.Date" + }, + "SupplierAccountNote": { + "type": "cds.String", + "length": 30 + }, + "WithholdingTaxCountry": { + "type": "cds.String", + "length": 3 + }, + "DeletionIndicator": { + "type": "cds.Boolean" + }, + "CashPlanningGroup": { + "type": "cds.String", + "length": 10 + }, + "IsToBeCheckedForDuplicates": { + "type": "cds.Boolean" + }, + "SupplierAccountGroup": { + "type": "cds.String", + "length": 4 + }, + "to_SupplierDunning": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_SupplierDunning", + "cardinality": { + "max": "*" + } + }, + "to_SupplierWithHoldingTax": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_SupplierWithHoldingTax", + "cardinality": { + "max": "*" + } + } + } + }, + "API_BUSINESS_PARTNER.A_SupplierDunning": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "Supplier": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "CompanyCode": { + "key": true, + "type": "cds.String", + "length": 4 + }, + "DunningArea": { + "key": true, + "type": "cds.String", + "length": 2 + }, + "DunningBlock": { + "type": "cds.String", + "length": 1 + }, + "DunningLevel": { + "type": "cds.String", + "length": 1 + }, + "DunningProcedure": { + "type": "cds.String", + "length": 4 + }, + "DunningRecipient": { + "type": "cds.String", + "length": 10 + }, + "LastDunnedOn": { + "type": "cds.Date" + }, + "LegDunningProcedureOn": { + "type": "cds.Date" + }, + "DunningClerk": { + "type": "cds.String", + "length": 2 + }, + "AuthorizationGroup": { + "type": "cds.String", + "length": 4 + }, + "SupplierAccountGroup": { + "type": "cds.String", + "length": 4 + } + } + }, + "API_BUSINESS_PARTNER.A_SupplierPartnerFunc": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "Supplier": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "PurchasingOrganization": { + "key": true, + "type": "cds.String", + "length": 4 + }, + "SupplierSubrange": { + "key": true, + "type": "cds.String", + "length": 6 + }, + "Plant": { + "key": true, + "type": "cds.String", + "length": 4 + }, + "PartnerFunction": { + "key": true, + "type": "cds.String", + "length": 2 + }, + "PartnerCounter": { + "key": true, + "type": "cds.String", + "length": 3 + }, + "DefaultPartner": { + "type": "cds.Boolean" + }, + "CreationDate": { + "type": "cds.Date" + }, + "CreatedByUser": { + "type": "cds.String", + "length": 12 + }, + "ReferenceSupplier": { + "type": "cds.String", + "length": 10 + }, + "AuthorizationGroup": { + "type": "cds.String", + "length": 4 + } + } + }, + "API_BUSINESS_PARTNER.A_SupplierPurchasingOrg": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "Supplier": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "PurchasingOrganization": { + "key": true, + "type": "cds.String", + "length": 4 + }, + "CalculationSchemaGroupCode": { + "type": "cds.String", + "length": 2 + }, + "DeletionIndicator": { + "type": "cds.Boolean" + }, + "IncotermsClassification": { + "type": "cds.String", + "length": 3 + }, + "IncotermsTransferLocation": { + "type": "cds.String", + "length": 28 + }, + "IncotermsVersion": { + "type": "cds.String", + "length": 4 + }, + "IncotermsLocation1": { + "type": "cds.String", + "length": 70 + }, + "IncotermsLocation2": { + "type": "cds.String", + "length": 70 + }, + "InvoiceIsGoodsReceiptBased": { + "type": "cds.Boolean" + }, + "MaterialPlannedDeliveryDurn": { + "type": "cds.Decimal", + "precision": 3, + "scale": 0 + }, + "MinimumOrderAmount": { + "type": "cds.Decimal", + "precision": 14, + "scale": 3 + }, + "PaymentTerms": { + "type": "cds.String", + "length": 4 + }, + "PricingDateControl": { + "type": "cds.String", + "length": 1 + }, + "PurOrdAutoGenerationIsAllowed": { + "type": "cds.Boolean" + }, + "PurchaseOrderCurrency": { + "type": "cds.String", + "length": 5 + }, + "PurchasingGroup": { + "type": "cds.String", + "length": 3 + }, + "PurchasingIsBlockedForSupplier": { + "type": "cds.Boolean" + }, + "ShippingCondition": { + "type": "cds.String", + "length": 2 + }, + "SupplierABCClassificationCode": { + "type": "cds.String", + "length": 1 + }, + "SupplierPhoneNumber": { + "type": "cds.String", + "length": 16 + }, + "SupplierRespSalesPersonName": { + "type": "cds.String", + "length": 30 + }, + "AuthorizationGroup": { + "type": "cds.String", + "length": 4 + }, + "SupplierAccountGroup": { + "type": "cds.String", + "length": 4 + }, + "to_PartnerFunction": { + "type": "cds.Association", + "target": "API_BUSINESS_PARTNER.A_SupplierPartnerFunc", + "cardinality": { + "max": "*" + } + } + } + }, + "API_BUSINESS_PARTNER.A_SupplierWithHoldingTax": { + "kind": "entity", + "@cds.persistence.skip": true, + "elements": { + "Supplier": { + "key": true, + "type": "cds.String", + "length": 10 + }, + "CompanyCode": { + "key": true, + "type": "cds.String", + "length": 4 + }, + "WithholdingTaxType": { + "key": true, + "type": "cds.String", + "length": 2 + }, + "ExemptionDateBegin": { + "type": "cds.Date" + }, + "ExemptionDateEnd": { + "type": "cds.Date" + }, + "ExemptionReason": { + "type": "cds.String", + "length": 2 + }, + "IsWithholdingTaxSubject": { + "type": "cds.Boolean" + }, + "RecipientType": { + "type": "cds.String", + "length": 2 + }, + "WithholdingTaxCertificate": { + "type": "cds.String", + "length": 25 + }, + "WithholdingTaxCode": { + "type": "cds.String", + "length": 2 + }, + "WithholdingTaxExmptPercent": { + "type": "cds.Decimal", + "precision": 5, + "scale": 2 + }, + "WithholdingTaxNumber": { + "type": "cds.String", + "length": 16 + }, + "AuthorizationGroup": { + "type": "cds.String", + "length": 4 + } + } + } + } +} \ No newline at end of file diff --git a/suppliers/srv/external/API_BUSINESS_PARTNER.edmx b/suppliers/srv/external/API_BUSINESS_PARTNER.edmx new file mode 100644 index 00000000..4da33b26 --- /dev/null +++ b/suppliers/srv/external/API_BUSINESS_PARTNER.edmx @@ -0,0 +1,3261 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Internal key for identifying a Business Address Services address. + For more information about the meaning and use of the address number and the Business Address Services concepts, see the function group SZA0 documentation. + + + + + Internal key for identifying a person in Business Address Services. + For more information about the meaning and use of the person number and Business Address Services concepts, see the function group SZA0 documentation. + + + + + + + Internet mail address, also called e-mail address. + Example: user.name@company.comThe Internet mail address is used to send mail via the Internet world-wide; the protocol used is SMTP (Simple Mail Transfer Protocol).The Internet mail address format is specified in various RFCs (Internet Request for Comment), including RFCs 821 and 822.This is not an IP address (192.56.30.6). + + + + + This field is generated by the system from the complete Internet mail address and is stored in table ADR6. + It contains the first 20 characters of the Internet mail address in normalized form, that is, without comment characters and converted into uppercase.The field cannot be maintained by the user or from an interface.The table ADR6 contains an index for this field.Using an Internet mail address, the corresponding key of table ADR6 and the owner of the address are determined (for example, business partner or user). + + + + + + + + + + + + Internal key for identifying a Business Address Services address. + For more information about the meaning and use of the address number and the Business Address Services concepts, see the function group SZA0 documentation. + + + + + Internal key for identifying a person in Business Address Services. + For more information about the meaning and use of the person number and Business Address Services concepts, see the function group SZA0 documentation. + + + + + + If several addresses are maintained for one communication type, the user in the SAP System can be reached under one of these addresses. One address can be set as theStandard Address. + The standard address is used for the following functions:When sending using the SMTP nodein SAPconnect, the home address of the communication type used is the one set as the sender address. The recipient can see this address in the sender information and can also reply directly to this address. The standard address is also transferred and can be used for incoming status notifications, for example.When sending using an RFC node in SAPconnect, the standard address of the communication type used is the one set as the sender address. The structure defined in the case of the RFC does not permit another address to be transferred, so the standard address is used for incoming status notifications too.The SAP users have the addresses of their exchange P.O. boxes in their standard communication type 'Internet Mail' as the home address and their Internet address in the SAP system as their standard address. Example:Home address: Bernard.Brown@Company.comStandard address: Bernard.Brown@System.Company.comSending using an SMTP nodeThe home address of the communication type 'Internet Mail' (Bernard.Brown@Company.com) is used as the sender address. If a reply is sent to this address the user receives directly in the exchange postbox.Sending using the RFC nodeThe standard address of the communication type 'Internet Mail' (Bernard.Brown@System.Company.com) is used as the sender address. If a reply is sent to this address, it arrives back to the SAP system.Example using a mail system groupThe users should get all messages in their Microsoft Exchange postboxes. In the SAP system the mail system group is activated for this using the setting "Send Messages to the Home Address".The address settings of the SAP users remain unchanged:Home address: Bernard.Brown@Company.comStandard address: Bernard.Brown@System.Company.comSending using an SMTP nodeThe home address of the communication type 'Internet Mail' (Bernard.Brown@Company.com) is used as the sender address. If a reply is sent to this address the user receives directly in the exchange postbox.Sending using the RFC nodeThe standard address of the communication type 'Internet Mail' (Bernard.Brown@System.Company.com) is used as the sender address. If a reply is sent to this address it arrives back in the SAP system. It is then forwarded using the mail system group to the home address and the user gets it in the exchange postbox. + + + + + The country for the telephone number or fax number is maintained here. + This specification is used to determine the correct country code. A normalized form of the telephone number or fax number is then derived and stored in a field for a program-driven search.In most cases, the telephone number or fax number refers directly to an address.If this is the case, when a new number is created, the country of the address is proposed.If this is not the case (for example, with address-independent communication data for a business partner), the country from the user parameter LND is proposed (if it is maintained). If the user parameter LND is not maintained, the country of the company address assigned in the user master data is proposed.If the country of the address changes, the country of the corresponding telephone number and fax address is not changed automatically.Example: A business partner moves abroad.If the telephone number is for a permanent connection, the telephone number also changes when the business partner moves and has to be maintained again in the system.If the telephone number is for a mobile telephone and the number is retained, the original country for this telephone number also has to be retained and must not be changed automatically to the new country of the address. + + + + + Fax number, consisting of dialling code and number, but without country dialling code. + If the fax number consists of a company number and an extension, the extension must be entered in the field extension.Fax number, as it is to be dialled from within the same country.Enter the following for the number "01234/567-0":Fax: 01234/567Extension: 0Enter the following for the number "01234/567-891":Fax: 01234/567Extension: 891For the number "012-345-678" (678 as extension) enter the following:Fax: 012-345Extension: 678In the following cases, enter the complete number (without country dialing code) in the field Fax:No part of the number can be considered as an extension.You are not sure which part of the number can be considered as an extension. + + + + + Fax extension number + If the fax number consists of a company number and an extension, the extension must be entered here.Enter the extensionThe following rules apply for the format of telephone and fax numbers:The length of the entries in the field Telephone and Extension (Fax and Extension) cannot be more than 24 characters in total.Leading spaces are not allowed in the field Telephone or Fax or in the field Extension.Valid characters are:Numbers (0123456789)Letters (ABCDEFGHIJKLMNOPQRSTUVWXYZ)Following other characters: /, (, ), - *, # and " " (space), but not as a leading space.If an + is entered as the first character, the system checks whether the specified number starts with a country code. If so, a warning message is displayed because the country code is automatically determined by the system and should not be stored in the Telephone number (Fax number) field.If an & is entered as the first character, the automatic check and formatting of the telephone number (fax number), as well as the determination of the country code, is suppressed.Enter the following for the number "01234/567-0":Fax: 01234/567Extension: 0Enter the following for the number "01234/567-891":Fax: 01234/567Extension: 891For the number "012-345-678" (678 as extension) enter the following:Fax: 012-345Extension: 678In the following cases, enter the complete number (without country dialing code) in the field Fax:No part of the number can be considered as an extension.You are not sure which part of the number can be considered as an extension. + + + + + The content of this field is automatically calculated by the system based on fax number and country code components. + This field is therefore not to be filled when Business Address Services function modules are called. + + + + + + + + + + + + + + Internal key for identifying a Business Address Services address. + For more information about the meaning and use of the address number and the Business Address Services concepts, see the function group SZA0 documentation. + + + + + Internal key for identifying a person in Business Address Services. + For more information about the meaning and use of the person number and Business Address Services concepts, see the function group SZA0 documentation. + + + + + + + + + + + + + + + + + + Internal key for identifying a Business Address Services address. + For more information about the meaning and use of the address number and the Business Address Services concepts, see the function group SZA0 documentation. + + + + + Internal key for identifying a person in Business Address Services. + For more information about the meaning and use of the person number and Business Address Services concepts, see the function group SZA0 documentation. + + + + + + The country for the telephone number or fax number is maintained here. + This specification is used to determine the correct country code. A normalized form of the telephone number or fax number is then derived and stored in a field for a program-driven search.In most cases, the telephone number or fax number refers directly to an address.If this is the case, when a new number is created, the country of the address is proposed.If this is not the case (for example, with address-independent communication data for a business partner), the country from the user parameter LND is proposed (if it is maintained). If the user parameter LND is not maintained, the country of the company address assigned in the user master data is proposed.If the country of the address changes, the country of the corresponding telephone number and fax address is not changed automatically.Example: A business partner moves abroad.If the telephone number is for a permanent connection, the telephone number also changes when the business partner moves and has to be maintained again in the system.If the telephone number is for a mobile telephone and the number is retained, the original country for this telephone number also has to be retained and must not be changed automatically to the new country of the address. + + + + + If several addresses are maintained for one communication type, the user in the SAP System can be reached under one of these addresses. One address can be set as theStandard Address. + The standard address is used for the following functions:When sending using the SMTP nodein SAPconnect, the home address of the communication type used is the one set as the sender address. The recipient can see this address in the sender information and can also reply directly to this address. The standard address is also transferred and can be used for incoming status notifications, for example.When sending using an RFC node in SAPconnect, the standard address of the communication type used is the one set as the sender address. The structure defined in the case of the RFC does not permit another address to be transferred, so the standard address is used for incoming status notifications too.The SAP users have the addresses of their exchange P.O. boxes in their standard communication type 'Internet Mail' as the home address and their Internet address in the SAP system as their standard address. Example:Home address: Bernard.Brown@Company.comStandard address: Bernard.Brown@System.Company.comSending using an SMTP nodeThe home address of the communication type 'Internet Mail' (Bernard.Brown@Company.com) is used as the sender address. If a reply is sent to this address the user receives directly in the exchange postbox.Sending using the RFC nodeThe standard address of the communication type 'Internet Mail' (Bernard.Brown@System.Company.com) is used as the sender address. If a reply is sent to this address, it arrives back to the SAP system.Example using a mail system groupThe users should get all messages in their Microsoft Exchange postboxes. In the SAP system the mail system group is activated for this using the setting "Send Messages to the Home Address".The address settings of the SAP users remain unchanged:Home address: Bernard.Brown@Company.comStandard address: Bernard.Brown@System.Company.comSending using an SMTP nodeThe home address of the communication type 'Internet Mail' (Bernard.Brown@Company.com) is used as the sender address. If a reply is sent to this address the user receives directly in the exchange postbox.Sending using the RFC nodeThe standard address of the communication type 'Internet Mail' (Bernard.Brown@System.Company.com) is used as the sender address. If a reply is sent to this address it arrives back in the SAP system. It is then forwarded using the mail system group to the home address and the user gets it in the exchange postbox. + + + + + Telephone number, consisting of dialling code and number, but without country dialling code. + If the telephone number consists of a company number and an extension, the extension must be entered in the field extension.Telephone number, as it is dialled from within the country.For the number "01234/567-0" enter the following:Telephone: 01234/567Estension: 0For the number "01234/567-891" enter the following:Telephone: 01234/567Extension: 891For the number "012-345-678" (678 as extension) enter the following:Telepone: 012-345Extension: 678In the following cases enter the complete number (without country dialling code) in the field Telephone:No part of the number can be regarded as an extension.You are not sure which part of the number can be regarded as an extension. + + + + + Telephone extension number + If the telephone number consists of a company number and an extension, the extension should be entered here.Enter the extension.The following rules apply for the format of telephone and fax numbers:The length of the entries in the field Telephone and Extension (Fax and Extension) cannot be more than 24 characters in total.Leading spaces are not allowed in the field Telephone or Fax or in the field Extension.Valid characters are:Numbers (0123456789)Letters (ABCDEFGHIJKLMNOPQRSTUVWXYZ)Following other characters: /, (, ), - *, # and " " (space), but not as a leading space.If an + is entered as the first character, the system checks whether the specified number starts with a country code. If so, a warning message is displayed because the country code is automatically determined by the system and should not be stored in the Telephone number (Fax number) field.If an & is entered as the first character, the automatic check and formatting of the telephone number (fax number), as well as the determination of the country code, is suppressed.For the number "01234/567-0" enter the following:Telephone: 01234/567Estension: 0For the number "01234/567-891" enter the following:Telephone: 01234/567Extension: 891For the number "012-345-678" (678 as extension) enter the following:Telepone: 012-345Extension: 678In the following cases enter the complete number (without country dialling code) in the field Telephone:No part of the number can be regarded as an extension.You are not sure which part of the number can be regarded as an extension. + + + + + The content of this field is automatically calculated by the system based on the telephone number and country code components. + This field is therefore not to be filled when Business Address Services function modules are called. + + + + + This field specifies whether the telephone number is a mobile telephone number. + ' ' : The telephone number is a fixed-line telephone'1' : The telephone number is the standard fixed-line telephone'2' : The telephone nubmer is a mobile telephone'3' : The telephone number is the standard mobile telephoneEither the standard fixed-line telephone number or the standard mobile telephone number is also the standard telephone number (FLGDEFAULT = 'X').In older data sets, this field may have also have the value ' ' for the standard fixed-line telephone. In this case, however, FLGDEFAULT is always 'X'.In Customizing, you can specify whether the SMS-compatible indicator is to be proposed for new mobile telephone numbers created in dialog by choosing General Settings -> Set countries -> Define Mobile Telephone Attributes for each country. + + + + + + + + + + + + + + The business partner relationship number is an internal number that identifies the business partner relationship set. + + + + + + Key identifying a business partner in the SAP system. The key is unique within a client. + + + + + + Key identifying a business partner in the SAP system. The key is unique within a client. + + + + + + + Internal key for identifying a Business Address Services address. + For more information about the meaning and use of the address number and the Business Address Services concepts, see the function group SZA0 documentation. + + + + + Internal key for identifying a Business Address Services address. + For more information about the meaning and use of the address number and the Business Address Services concepts, see the function group SZA0 documentation. + + + + + Additional address field which is printed above the Street line. + The Street address contains two lines above the street and two lines below the street.See Print the Street address. + + + + + Additional address field which is printed under the Street line. + The Street address has two lines above the street and two lines below the steet.See Print the Street address. + + + + + Time zone as part of an address. + The time zone is automatically determined by the system in address maintenance if time zone Customizing is maintained.It depends on the country and the region. (Region means state, province or county, depending on the country)The automatic determination is only made if there is no value in the time zone field. + + + + + Part of the address (c/o = care of) if the recipient is different from the occupant and the names are not similar (e.g. subtenants). + Put the country-specific code (e.g. c/o) in front of the name of the occupant. This is not automatically done in the print format, like the language-specific word "PO Box".John Smithc/o David BrownThis field is not always automatically printed, as it was subsequently added to the address structure.The print program or form may need to be adjusted.This exception applies to the following fields:Street2, Street3, Street4, Street5, c/o name, and to all address fields added after Release 4.5. + + + + + + City name as part of the address. + The city name is saved redundantly in another database field in upper- case letters, for search help.If the Postal regional structure ('city file') is active, the city name is checked against the Cities defined in the regional structure. + + + + + Postal code that is assigned directly to one company (= company postal code = major customer postal code). + This field is used for countries where major companies are assigned their own postal code by the national post office.This postal code has to be entered in the field "Company Postal Code". Postal codes for group major customers, however, have to be entered in the field "PO Box Postal Code", since individual customers with a shared postal code for group major customers are differentiated by means of their PO box. + + + + + The country key contains information which the system uses to check entries such as the length of the postal code or bank account number. + The two-character ISO code in accordance with ISO 3166, which is delivered by SAP as a default, is usually used.It could also be the vehicle license plate country-code or a typical country key, for example, in Germany the Federal statistics office key.The country keys are determined at system installation in the global settings.The definition of the country key in the SAP system does not have to match political or government entities.Since the country key does not have to correspond to the ISO code in all installations, programs that differ according to certain values of the country key cannot query the country key T005-LAND1, but have to program based on the ISO code T005 INTCA. + + + + + Specifies the county’s name + This field is used to store the county’s name. You can enter the name of the county in this field. + + + + + The delivery service is part of the PO box address. + Some countries offer different services in addition to regular postal delivery and PO boxes, for example the Private Bag or Response Bag. If an address is related to one of these delivery services, the information about this particular delivery service has to be entered in the corresponding fields.In the field "Number of Delivery Service," the number of the Private Bag, Response Bag, or other relevant service has to be entered. Entering a number is not mandatory for each delivery service.For each address, either the information about the PO box or the information about the delivery service can be entered, but not both types of information at the same time.Mr PickeringPrivate Bag 106999Timaru 7942Delivery services will only be taken into account for address formatting in countries in which they are commonly used in addition to regular postal delivery and PO boxes, for example, in Australia, New Zealand, and the USA. In all other countries, these fields will not be taken into account for address formatting. + + + + + The delivery service is part of the PO box address. + Some countries offer different services in addition to regular postal delivery and PO boxes, for example the Private Bag or Response Bag. If an address is related to one of these delivery services, the information about this particular delivery service has to be entered in the corresponding fields.In the field "Type of Delivery Service," the type of the delivery service has to be entered.For each address, either the information about the PO box or the information about the delivery service can be entered, but not both types of information at the same time.Mr PickeringPrivate Bag 106999Timaru 7942Delivery services will only be taken into account for address formatting in countries in which they are commonly used in addition to regular postal delivery and PO boxes, for example, in Australia, New Zealand, and the USA. In all other countries, these fields will not be taken into account for address formatting. + + + + + City or District supplement + In some countries, this entry is appended with a hyphen to the city name by the automatic address formatting, other countries, it is output on a line of its own or (e.g. in the USA) not printed.See the examples in the Address Layout Key documentation. + + + + + Key for form of address text. + You can also define a form of address text in Customizing.The form of address text can be maintained in different languages. + + + + + This field contains the full name or formatted name of a party. + For organizations or document addresses, typically the fields Name1 and Name2 are concatenated.For persons the field contains the formatted name according to country specific rules. It corresponds e.g. to the content of the fields BUT000-NAME1_TEXT or ADRP-NAME_TEXT. + + + + + City of residence which is different from the postal city + In some countries, the residential city is required if it differs from the postal city.In the USA, the official street indexes, against which data can be checked, are based on the residential city, not the postal city, which may be different.It is the same in France, where a postally correct address must contain the residential city in a separate line above the postal city, if it differs from the postal city.This field is not always automatically printed, as it was subsequently added to the address structure.The print program or form may need to be adjusted.This exception applies to the following fields:Street2, Street3, Street4, Street5, c/o name, and to all address fields added after Release 4.5. + + + + + House number as part of an address. + It is printed in the Street line.Other supplementary street information can be entered in the House number supplement or one of the Street2, Street3, Street4 or Street5 fields. See Print the Street address.A house number (e.g. 117) or a house number with supplement (e.g. 117a), or a house number range (e.g. 16-20), can be maintained in this field. + + + + + House number supplement as part of an address, e.g. + App. 17 orSuite 600.It is printed in the Street line.Further Street supplements can be put in one of the fields Street2, Street3, Street4 or Street5.See Print the Street address. + + + + + The language key indicates + - the language in which texts are displayed,- the language in which you enter texts,- the language in which the system prints texts. + + + + + PO Box number as part of an address. + Only enter the PO Box number in this field. The text "PO Box" is provided in the recipient language by the system when you print the address.When you print an address, the "Street address" and the "PO Box address" are distinguished. The print program determines which of them has priority if both are maintained in an address record.Besides the PO Box number, the PO Box address uses the following fields:PO Box postal code, if specified (otherwise the normal postal code)PO Box city, if specified (otherwise the normal city)PO Box region, if specified (otherwise the normal region)PO Box country, if specified (otherwise the normal country)If the address is a "PO Box" (without a number), do not fill the "PO Box" field. Select the "PO Box w/o Number" indicator instead.You can also enter a company postal code for organizational addresses, instead of a PO Box. A separate field is predefined for this entry.For general information and examples about address formatting, see the documentation on the Address Structure Key. + + + + + Different city for the PO Box as an address component. + The PO Box city can be entered here if it is different from the address city.If the address is only a PO Box address, enter the city in the normal city field.If the address contains two different city names for the address and the PO Box address, use this field. + + + + + Different PO Box country in address. + The PO Box country can be entered here, if it is different from the street address country.If the address only has a PO Box address, the country is in the normal country field.Use this field if the address has two different country values for the street address and the PO Box address.This field is not always automatically printed, as it was subsequently added to the address structure.The print program or form may need to be adjusted.This exception applies to the following fields:Street2, Street3, Street4, Street5, c/o name, and to all address fields added after Release 4.5. + + + + + Different Region for PO Box in an address. + Enter the PO Box Region here, if it differs from the street address region.If the address only has a PO Box address, the Region in in the normal Region field.Use this field if the address has two different Region values for the street address and the PO Box address.This field is not always automatically printed, as it was subsequently added to the address structure.The print program or form may need to be adjusted.This exception applies to the following fields:Street2, Street3, Street4, Street5, c/o name, and to all address fields added after Release 4.5. + + + + + PO Box address without PO Box number flag. + Only the word 'PO Box' is output in PO Box addresses without PO Box number.Set this flag for a PO Box address without PO Box number.This field is not always automatically printed, as it was subsequently added to the address structure.The print program or form may need to be adjusted.This exception applies to the following fields:Street2, Street3, Street4, Street5, c/o name, and to all address fields added after Release 4.5. + + + + + The PO box lobby is part of the PO box address. + In some countries, entering a PO box, postal code and city is not sufficient to uniquely identify a PO box, because the same PO box number is assigned multiple times in some cities.Therefore, additional information might be required to determine the post office of the PO box in question. This information can be entered in the field "PO Box Lobby."Mr NellingPO Box 4099HighfieldTimaru 7942The PO box lobby will only be taken into account for address formatting in countries in which it is commonly used in addition to regular postal delivery and PO boxes, for example, in Canada or New Zealand. In all other countries, this field will not be taken into account for address formatting. + + + + + Postal code that is required for a unique assignment of the PO box. + This field is used for countries where a different postal code applies to mail that is sent to the PO box rather than to the street address of a particular business partner.Postal codes for group major customers also have to be entered in the field for the PO box postal code since individual customers with a shared postal code for group major customers are differentiated by means of the PO box. Postal codes for major customers (= company postal codes), however, are assigned to one customer only and have to be entered in the field 'Company Postal Code'. + + + + + Internal key for identifying a person in Business Address Services. + For more information about the meaning and use of the person number and Business Address Services concepts, see the function group SZA0 documentation. + + + + + Postal code as part of the address + If different postal codes are maintained for the PO Box and Street address of an address, this field contains the Street address postal code. + + + + + Communication method with which you can exchange documents and messages with a business partner. + In Business Address Services, you can specify a standard communication method that can be used by programs to determine the means of communication for sending messages.One business partner wants all messages by fax, another by e-mail.The application context can restrict the possible methods of communication. For example, invitations should perhaps only be sent by post because of enclosures, whereas minutes can be sent by post, fax or e-mail.Communication strategies can be defined for this purpose and applied in application contexts. + + + + + In some countries, the region forms part of the address. The meaning depends on the country. + The automatic address formatting function prints the region in addresses in the USA, Canada, Italy, Brazil or Australia, and the county in Great Britain.For more information, see the examples in the documentation on the Address Layout Key.Meaning of the regional code in ...Australia -> ProvinceBrazil -> StateCanada -> ProvinceGermany -> StateGreat Britain -> CountyItaly -> ProvinceJapan -> PrefectureSwitzerland -> CantonUSA -> State + + + + + Street name as part of the address. + The street name is saved, redundantly in upper case in another database field, for search help purposes.There are other fields for address parts which can be printed above or below the street. See Print the Street address.The house number and other supplements are usually maintained in their own fields. See Formatting the Street line. + + + + + Additional address field which is printed above the Street line. + The Street address contains two lines above the street and two lines below the street.See Print the Street address.This field is not always automatically printed, as it was subsequently added to the address structure.The print program or form may need to be adjusted.This exception applies to the following fields:Street2, Street3, Street4, Street5, c/o name, and to all address fields added after Release 4.5. + + + + + Additional address field which is printed below the Street line. + The Street address contains two lines above the street and two lines below the street.See Print the Street address. + + + + + Specifies the tax jurisdiction. + + + + + + Sales and distribution: + Regional zone of Goods recipient.Purchasing:Regional zone of supplier.You can define regional zones to suit the requirements of your own business and country.Sales and distributionthe system automatically proposes a suitable route by using the transportation zone of the goods recipient in combination with other information about the delivery, such as theCountries of origin and destinationShipping conditionsTransportation groupIn the USA, for example, you can define regional zones to correspond to the US postal zip codes. + + + + + + + + + + + + + + + + + + The business partner relationship number is an internal number that identifies the business partner relationship set. + + + + + + Key identifying a business partner in the SAP system. The key is unique within a client. + + + + + + Key identifying a business partner in the SAP system. The key is unique within a client. + + + + + + + Identifies the function that a person has within a company. + This is a contact person attribute that you can define in Customizing.Personnel managerSecretary + + + + + Name of the department of a business partner for your internal usage. + The name given by the business partner to this particular department may differ from the name that you use. You can enter the name given by the business partner in the field company department.This is a contact person attribute that you can define in Customizing.For your purposes, the department name is "Sales". The business partner names the same department "Sales South". + + + + + Telephone number, consisting of dialling code and number, but without country dialling code. + If the telephone number consists of a company number and an extension, the extension must be entered in the field extension.Telephone number, as it is dialled from within the country.For the number "01234/567-0" enter the following:Telephone: 01234/567Estension: 0For the number "01234/567-891" enter the following:Telephone: 01234/567Extension: 891For the number "012-345-678" (678 as extension) enter the following:Telepone: 012-345Extension: 678In the following cases enter the complete number (without country dialling code) in the field Telephone:No part of the number can be regarded as an extension.You are not sure which part of the number can be regarded as an extension. + + + + + Telephone extension number + If the telephone number consists of a company number and an extension, the extension should be entered here.Enter the extension.The following rules apply for the format of telephone and fax numbers:The length of the entries in the field Telephone and Extension (Fax and Extension) cannot be more than 24 characters in total.Leading spaces are not allowed in the field Telephone or Fax or in the field Extension.Valid characters are:Numbers (0123456789)Letters (ABCDEFGHIJKLMNOPQRSTUVWXYZ)Following other characters: /, (, ), - *, # and " " (space), but not as a leading space.If an + is entered as the first character, the system checks whether the specified number starts with a country code. If so, a warning message is displayed because the country code is automatically determined by the system and should not be stored in the Telephone number (Fax number) field.If an & is entered as the first character, the automatic check and formatting of the telephone number (fax number), as well as the determination of the country code, is suppressed.For the number "01234/567-0" enter the following:Telephone: 01234/567Estension: 0For the number "01234/567-891" enter the following:Telephone: 01234/567Extension: 891For the number "012-345-678" (678 as extension) enter the following:Telepone: 012-345Extension: 678In the following cases enter the complete number (without country dialling code) in the field Telephone:No part of the number can be regarded as an extension.You are not sure which part of the number can be regarded as an extension. + + + + + Fax number, consisting of dialling code and number, but without country dialling code. + If the fax number consists of a company number and an extension, the extension must be entered in the field extension.Fax number, as it is to be dialled from within the same country.Enter the following for the number "01234/567-0":Fax: 01234/567Extension: 0Enter the following for the number "01234/567-891":Fax: 01234/567Extension: 891For the number "012-345-678" (678 as extension) enter the following:Fax: 012-345Extension: 678In the following cases, enter the complete number (without country dialing code) in the field Fax:No part of the number can be considered as an extension.You are not sure which part of the number can be considered as an extension. + + + + + Fax extension number + If the fax number consists of a company number and an extension, the extension must be entered here.Enter the extensionThe following rules apply for the format of telephone and fax numbers:The length of the entries in the field Telephone and Extension (Fax and Extension) cannot be more than 24 characters in total.Leading spaces are not allowed in the field Telephone or Fax or in the field Extension.Valid characters are:Numbers (0123456789)Letters (ABCDEFGHIJKLMNOPQRSTUVWXYZ)Following other characters: /, (, ), - *, # and " " (space), but not as a leading space.If an + is entered as the first character, the system checks whether the specified number starts with a country code. If so, a warning message is displayed because the country code is automatically determined by the system and should not be stored in the Telephone number (Fax number) field.If an & is entered as the first character, the automatic check and formatting of the telephone number (fax number), as well as the determination of the country code, is suppressed.Enter the following for the number "01234/567-0":Fax: 01234/567Extension: 0Enter the following for the number "01234/567-891":Fax: 01234/567Extension: 891For the number "012-345-678" (678 as extension) enter the following:Fax: 012-345Extension: 678In the following cases, enter the complete number (without country dialing code) in the field Fax:No part of the number can be considered as an extension.You are not sure which part of the number can be considered as an extension. + + + + + Internet mail address, also called e-mail address. + Example: user.name@company.comThe Internet mail address is used to send mail via the Internet world-wide; the protocol used is SMTP (Simple Mail Transfer Protocol).The Internet mail address format is specified in various RFCs (Internet Request for Comment), including RFCs 821 and 822.This is not an IP address (192.56.30.6). + + + + + A relationship may exist between two business partners. The business partner relationship category characterizes the features of the relationship. + A distinction is made between a one-way and an undirected business partner relationship category. In a one-way relationship category, the relationship extends from one partner to another, but not vice versa.Marriage (undirected)Employee (one-way)Contact person (one-way) + + + + + + + + + + + + + Key identifying a business partner in the SAP system. The key is unique within a client. + + + + + + + Business partner attribute, which you can use to distinguish between various addresses by defining the address usage for communication with business partners. + Maintain the usage types for addresses (address types) in Customizing.You can create a short description and a name for the address type.When maintaining business partners you can use the function address usage to assign business partner addresses to address types.If necessary, you can set the indicator for multiple use in Customizing.Correspondence addressDelivery address + + + + + Internal key for identifying a Business Address Services address. + For more information about the meaning and use of the address number and the Business Address Services concepts, see the function group SZA0 documentation. + + + + + + Establishes which is the standard address for an address usage. + Several addresses per period can be assigned to an address usage.If this is the case, then this indicator controls which of the assigned addresses should be the standard address of the relevant usage. This is determined automatically when the address usage is accessed. + + + + + You can use authorization groups to stipulate which business partners a user is allowed to process. + Use the following authorization object:'Business partners: authorization groups' (B_BUPA_GRP).The system only checks this authorization if you made an entry in the "Authorization group" field for the business partner. Otherwise, any user may process the business partner. + + + + + + + + + + + + Key identifying a business partner in the SAP system. The key is unique within a client. + + + + + + A document (such as an ID card or driver's license) or an entry in a system of records (such as a commercial register) whose key can be stored as an attribute for a business partner. + The identification type is for classifying identification numbers.You can define the identification types and their descriptions in Customizing.You can also specify for which business partner category an ID type should be valid.If necessary, assign the identification type to an Identification Category.You can only assign one identification type to an identification category. + + + + + Number that serves to identify a business partner, such as driver's license, or ID card number. + + + + + + Institution that adminsters or assigns an ID number. + + + + + + Date on which the ID number was registered or assigned by the appropriate authority. + + + + + + Country in which an ID number was assigned, or in which the number is valid. + + + + + + In some countries, the region forms part of the address. The meaning depends on the country. + The automatic address formatting function prints the region in addresses in the USA, Canada, Italy, Brazil or Australia, and the county in Great Britain.For more information, see the examples in the documentation on the Address Layout Key.Meaning of the regional code in ...Australia -> ProvinceBrazil -> StateCanada -> ProvinceGermany -> StateGreat Britain -> CountyItaly -> ProvinceJapan -> PrefectureSwitzerland -> CantonUSA -> State + + + + + This date marks the start of validity of an ID number. + + + + + + This date marks the end of validity of an ID number. + + + + + + You can use authorization groups to stipulate which business partners a user is allowed to process. + Use the following authorization object:'Business partners: authorization groups' (B_BUPA_GRP).The system only checks this authorization if you made an entry in the "Authorization group" field for the business partner. Otherwise, any user may process the business partner. + + + + + + + + + + + + Describes an industry. + An industry is a classification of companies according to their main business activity. For example, you can use Commerce, Banking, Services, Industry, Healthcare, Public Sector, Media, and so on, as industries.You can define industries along with their descriptions in Customizing.Assign the industry key to an industry key system. + + + + + Serves to combine and categorize several industries into a group. + You can create different industry systems, each with its own catalog of industries, whereby an industry can be assigned to several industry systems.You have to select one industry system as the standard industry system. This is then automatically displayed in the initial screen for the maintenance of industry data.You can define an industry system along with its description in Customizing. You can assign several industry systems to a business partner.If you choose the button All Industry Systems, you can access all the industry systems defined in the Customizing using the input help. + + + + + Key identifying a business partner in the SAP system. The key is unique within a client. + + + + + + Identifies the industry in an industry system that can be defined as the standard industry. + It is recommended that you define an industry within an industry system as the standard industry, because only the standard industries can be determined at the interfaces to BW or the APIs, for example.This means that even if only one industry exists within an industry system, it should be indicated as the standard industry as this this information cannot be determined otherwise. + + + + + + + + + + + Key identifying a business partner in the SAP system. The key is unique within a client. + + + + + + Gives an alphanumeric key, which clearly identifies the customer or vendor in the SAP system. + + + + + + Specifies an alphanumeric key that uniquely identifies the supplier in the SAP system. + + + + + + Key for academic title. + You can define a key for an academic title in Customizing. + + + + + You can use authorization groups to stipulate which business partners a user is allowed to process. + Use the following authorization object:'Business partners: authorization groups' (B_BUPA_GRP).The system only checks this authorization if you made an entry in the "Authorization group" field for the business partner. Otherwise, any user may process the business partner. + + + + + Category under which a business partner is classified. + You can distinguish between the following business partner categories:OrganizationNatural personGroup of natural persons or organizationsThe processing screens for the business partner categories are set up differently.So, for example, the screen for an organization contains the field Legal form, but this is not needed in the screen for a natural person. + + + + + + Classification assigned when creating a business partner. + Assign each business partner to a grouping when you create the business partner. The grouping determines the number range. You cannot change the assignment afterwards.You can define the groupings, their descriptions, the associated number range and other attributes in Customizing.You can define standard groupings for the internal and the external number assignment.For each grouping create a number range.When you create a business partner, the entry in the grouping field determines whether and how an entry is made in the business partner number field. + + + + + + + Correspondence language (written) for business partners in the 'Person' category. Maintain the correspondence language for business partners in the 'Organization' and 'Group' category with the address (communication). + When transferring data (direct input), make sure that for a'Person', the field 'LANGU_CORR' and for an'Organization' or "Group" the field 'LANGU'has an entry. + + + + + + + + + Key for form of address text. + You can also define a form of address text in Customizing.The form of address text can be maintained in different languages. + + + + + An industry sector is the term used to classify a company according to its main business activity. + You can assign an industry sector to business partners in the category 'Organization'RetailBanksServicesIndustryHealth servicePublic sectorMedia + + + + + Here you enter the first 7 digits of the international location number. + The International Location Number (ILN) is assigned (in Germany by the Centrale for Coorganisation GmbH)) when a company is founded. It consists of 13 digits, the last digit being the check digit. There are two categories of location numbers:Participants who only need an ILN to cleary and unmistakably identify themselves for communication with the business partner are given a category 1 ILN. This cannot be used to identify articles by means of EAN.Participants who wish to assign the location numbers for their own enterprise areas are given a category 2 ILN. For a category 2 ILN, digits 1 to 7 are described as basis number. This is used as basis for the creation of article numbers (EAN). + + + + + Here, you enter digits 8-12 of the 13-digit international location number. + The international location number (ILN) is assigned when establishing a company (by the "Zentrale für Coorganisation GmbH" in Germany). It consists of 13 digits, the last of which is the check digit. There are two types of international location numbers:Subscribers who only need one ILN to identify themselves in communication with the business partner are given an ILN of type 1. These cannot be used for identifying articles by means of EAN.Subscribers who need to assign location numbers for their own company areas are given an ILN of type 2. Positions 1 through 7 of the ILN type 2 are known as the basis number. This basis number forms the basis for article numbers (EAN). + + + + + + + Indicator through which a distinction between natural and legal persons can be made during tax reporting. + Is used in Italy and Mexico ,among other countries.Brasil: If the indicator is not set, 'CGC' is relevant in tax number 1. If the indicator is set, 'CPF' is relevant in tax number 2.Colombia: In the case of some natural persons, the NIT number does not have a check digit. In this case you should set this indicator and the check is deactivated. + + + + + + Language for verbal communication with a business partner. + This language may differ from the language(s) defined for written correspondence. + + + + + + + + + Denotes certain legal norms that are of significance for the organization of a company. + For business partners in the category "Organization", you can state the legal form of the company. This is for information purposes only.Stock corporation (AG in Germany)Limited liability company (GmbH in Germany) + + + + + First name field for business partners in the Organization category. + + + + + + Second name field for business partners in the Organization category. + + + + + + Third name field for business partners in the Organization category. + + + + + + Fourth name field for business partners in the Organization category. + + + + + + Indicates the official registration of a company in the Commercial Register. + If a company is not officially registered in the Commercial Register, it has to use some type of text addition, such as foundation pending, when referring to the legal form. + + + + + Term for the end of bankruptcy proceedings. + This date also indicates that the company no longer exists. + + + + + Denotes the term that you define for a business partner, and via which you can restrict the search for a business partner in the business partner search or in the locator. + + + + + + + + If the business partner is blocked centrally, certain activities cannot be executed. + + + + + + You can use the business partner type to group business partners according to your own criteria in Customizing (IMG). + In Customizing you can show or hide fields for data entry, depending on the requirements of the relevant business partner type.Select a business partner type. You can obtain help by pressing the F4 key. + + + + + + First name field for business partners in the Group category. + + + + + + Second name field for business partners in the Group category. + + + + + + Internal key for identifying the address for communication data that spans all addresses in Business Partner. + For more information on the significance and usage of the address number, see the documentation for Business Address Services (BAS). + + + + + The check digit is derived from a special check digit procedure from digits of the previous international location numbers. In this way, you can check whether the ILN entered is actually valid. + + + + + + + The name format rule country and the name format rule key together uniquely identify a formatting rule. + A country can have several formats which correspond to different rules. Formatting rules describe the format of a person name. + + + + + See Name format. + + + + + + States the complete name of a person. + The complete name is generally generated and saved by the Business Address Services (BAS) according to country-specific rules from the individual name components (without the form of address).If, during the formatting of an address, you want to use an alternative name, you can manually format the alternative name here. + + + + + Internal key for identifying a person in Business Address Services. + For more information about the meaning and use of the person number and Business Address Services concepts, see the function group SZA0 documentation. + + + + + Establishes if the business partner is meant to be archived. + If the indicator is set, the relevant business partner can be archived from the view of the business partner administration.If the check of the data to be archived shows, for example, that there are still active business transactions the archiving of the business partner data is prevented even if the indicator is set.If the indicator is not set, the business partner will not be taken into consideration during archiving. + + + + + Business partner number from an external system or a legacy system. + If the current business partner is known under a different number in an external system, you can store this number here for information purposes.Direct input gives you the option of maintaining a business partner by specifying the external business partner number. If you maintain business partner data in your legacy system, you can transmit changes made to business partners to the SAP system without having to know the SAP business partner number in the legacy system. + + + + + Company ID standard for the whole group. + + + + + + + + + + + + + + + + + + + + + Key identifying a business partner in the SAP system. The key is unique within a client. + + + + + + Internal key for identifying a Business Address Services address. + For more information about the meaning and use of the address number and the Business Address Services concepts, see the function group SZA0 documentation. + + + + + + + You can use authorization groups to stipulate which business partners a user is allowed to process. + Use the following authorization object:'Business partners: authorization groups' (B_BUPA_GRP).The system only checks this authorization if you made an entry in the "Authorization group" field for the business partner. Otherwise, any user may process the business partner. + + + + + + Additional address field which is printed above the Street line. + The Street address contains two lines above the street and two lines below the street.See Print the Street address. + + + + + Additional address field which is printed under the Street line. + The Street address has two lines above the street and two lines below the steet.See Print the Street address. + + + + + Time zone as part of an address. + The time zone is automatically determined by the system in address maintenance if time zone Customizing is maintained.It depends on the country and the region. (Region means state, province or county, depending on the country)The automatic determination is only made if there is no value in the time zone field. + + + + + Part of the address (c/o = care of) if the recipient is different from the occupant and the names are not similar (e.g. subtenants). + Put the country-specific code (e.g. c/o) in front of the name of the occupant. This is not automatically done in the print format, like the language-specific word "PO Box".John Smithc/o David BrownThis field is not always automatically printed, as it was subsequently added to the address structure.The print program or form may need to be adjusted.This exception applies to the following fields:Street2, Street3, Street4, Street5, c/o name, and to all address fields added after Release 4.5. + + + + + + City name as part of the address. + The city name is saved redundantly in another database field in upper- case letters, for search help.If the Postal regional structure ('city file') is active, the city name is checked against the Cities defined in the regional structure. + + + + + Postal code that is assigned directly to one company (= company postal code = major customer postal code). + This field is used for countries where major companies are assigned their own postal code by the national post office.This postal code has to be entered in the field "Company Postal Code". Postal codes for group major customers, however, have to be entered in the field "PO Box Postal Code", since individual customers with a shared postal code for group major customers are differentiated by means of their PO box. + + + + + The country key contains information which the system uses to check entries such as the length of the postal code or bank account number. + The two-character ISO code in accordance with ISO 3166, which is delivered by SAP as a default, is usually used.It could also be the vehicle license plate country-code or a typical country key, for example, in Germany the Federal statistics office key.The country keys are determined at system installation in the global settings.The definition of the country key in the SAP system does not have to match political or government entities.Since the country key does not have to correspond to the ISO code in all installations, programs that differ according to certain values of the country key cannot query the country key T005-LAND1, but have to program based on the ISO code T005 INTCA. + + + + + Specifies the county’s name + This field is used to store the county’s name. You can enter the name of the county in this field. + + + + + The delivery service is part of the PO box address. + Some countries offer different services in addition to regular postal delivery and PO boxes, for example the Private Bag or Response Bag. If an address is related to one of these delivery services, the information about this particular delivery service has to be entered in the corresponding fields.In the field "Number of Delivery Service," the number of the Private Bag, Response Bag, or other relevant service has to be entered. Entering a number is not mandatory for each delivery service.For each address, either the information about the PO box or the information about the delivery service can be entered, but not both types of information at the same time.Mr PickeringPrivate Bag 106999Timaru 7942Delivery services will only be taken into account for address formatting in countries in which they are commonly used in addition to regular postal delivery and PO boxes, for example, in Australia, New Zealand, and the USA. In all other countries, these fields will not be taken into account for address formatting. + + + + + The delivery service is part of the PO box address. + Some countries offer different services in addition to regular postal delivery and PO boxes, for example the Private Bag or Response Bag. If an address is related to one of these delivery services, the information about this particular delivery service has to be entered in the corresponding fields.In the field "Type of Delivery Service," the type of the delivery service has to be entered.For each address, either the information about the PO box or the information about the delivery service can be entered, but not both types of information at the same time.Mr PickeringPrivate Bag 106999Timaru 7942Delivery services will only be taken into account for address formatting in countries in which they are commonly used in addition to regular postal delivery and PO boxes, for example, in Australia, New Zealand, and the USA. In all other countries, these fields will not be taken into account for address formatting. + + + + + City or District supplement + In some countries, this entry is appended with a hyphen to the city name by the automatic address formatting, other countries, it is output on a line of its own or (e.g. in the USA) not printed.See the examples in the Address Layout Key documentation. + + + + + Key for form of address text. + You can also define a form of address text in Customizing.The form of address text can be maintained in different languages. + + + + + This field contains the full name or formatted name of a party. + For organizations or document addresses, typically the fields Name1 and Name2 are concatenated.For persons the field contains the formatted name according to country specific rules. It corresponds e.g. to the content of the fields BUT000-NAME1_TEXT or ADRP-NAME_TEXT. + + + + + City of residence which is different from the postal city + In some countries, the residential city is required if it differs from the postal city.In the USA, the official street indexes, against which data can be checked, are based on the residential city, not the postal city, which may be different.It is the same in France, where a postally correct address must contain the residential city in a separate line above the postal city, if it differs from the postal city.This field is not always automatically printed, as it was subsequently added to the address structure.The print program or form may need to be adjusted.This exception applies to the following fields:Street2, Street3, Street4, Street5, c/o name, and to all address fields added after Release 4.5. + + + + + House number as part of an address. + It is printed in the Street line.Other supplementary street information can be entered in the House number supplement or one of the Street2, Street3, Street4 or Street5 fields. See Print the Street address.A house number (e.g. 117) or a house number with supplement (e.g. 117a), or a house number range (e.g. 16-20), can be maintained in this field. + + + + + House number supplement as part of an address, e.g. + App. 17 orSuite 600.It is printed in the Street line.Further Street supplements can be put in one of the fields Street2, Street3, Street4 or Street5.See Print the Street address. + + + + + The language key indicates + - the language in which texts are displayed,- the language in which you enter texts,- the language in which the system prints texts. + + + + + PO Box number as part of an address. + Only enter the PO Box number in this field. The text "PO Box" is provided in the recipient language by the system when you print the address.When you print an address, the "Street address" and the "PO Box address" are distinguished. The print program determines which of them has priority if both are maintained in an address record.Besides the PO Box number, the PO Box address uses the following fields:PO Box postal code, if specified (otherwise the normal postal code)PO Box city, if specified (otherwise the normal city)PO Box region, if specified (otherwise the normal region)PO Box country, if specified (otherwise the normal country)If the address is a "PO Box" (without a number), do not fill the "PO Box" field. Select the "PO Box w/o Number" indicator instead.You can also enter a company postal code for organizational addresses, instead of a PO Box. A separate field is predefined for this entry.For general information and examples about address formatting, see the documentation on the Address Structure Key. + + + + + Different city for the PO Box as an address component. + The PO Box city can be entered here if it is different from the address city.If the address is only a PO Box address, enter the city in the normal city field.If the address contains two different city names for the address and the PO Box address, use this field. + + + + + Different PO Box country in address. + The PO Box country can be entered here, if it is different from the street address country.If the address only has a PO Box address, the country is in the normal country field.Use this field if the address has two different country values for the street address and the PO Box address.This field is not always automatically printed, as it was subsequently added to the address structure.The print program or form may need to be adjusted.This exception applies to the following fields:Street2, Street3, Street4, Street5, c/o name, and to all address fields added after Release 4.5. + + + + + Different Region for PO Box in an address. + Enter the PO Box Region here, if it differs from the street address region.If the address only has a PO Box address, the Region in in the normal Region field.Use this field if the address has two different Region values for the street address and the PO Box address.This field is not always automatically printed, as it was subsequently added to the address structure.The print program or form may need to be adjusted.This exception applies to the following fields:Street2, Street3, Street4, Street5, c/o name, and to all address fields added after Release 4.5. + + + + + PO Box address without PO Box number flag. + Only the word 'PO Box' is output in PO Box addresses without PO Box number.Set this flag for a PO Box address without PO Box number.This field is not always automatically printed, as it was subsequently added to the address structure.The print program or form may need to be adjusted.This exception applies to the following fields:Street2, Street3, Street4, Street5, c/o name, and to all address fields added after Release 4.5. + + + + + The PO box lobby is part of the PO box address. + In some countries, entering a PO box, postal code and city is not sufficient to uniquely identify a PO box, because the same PO box number is assigned multiple times in some cities.Therefore, additional information might be required to determine the post office of the PO box in question. This information can be entered in the field "PO Box Lobby."Mr NellingPO Box 4099HighfieldTimaru 7942The PO box lobby will only be taken into account for address formatting in countries in which it is commonly used in addition to regular postal delivery and PO boxes, for example, in Canada or New Zealand. In all other countries, this field will not be taken into account for address formatting. + + + + + Postal code that is required for a unique assignment of the PO box. + This field is used for countries where a different postal code applies to mail that is sent to the PO box rather than to the street address of a particular business partner.Postal codes for group major customers also have to be entered in the field for the PO box postal code since individual customers with a shared postal code for group major customers are differentiated by means of the PO box. Postal codes for major customers (= company postal codes), however, are assigned to one customer only and have to be entered in the field 'Company Postal Code'. + + + + + Internal key for identifying a person in Business Address Services. + For more information about the meaning and use of the person number and Business Address Services concepts, see the function group SZA0 documentation. + + + + + Postal code as part of the address + If different postal codes are maintained for the PO Box and Street address of an address, this field contains the Street address postal code. + + + + + Communication method with which you can exchange documents and messages with a business partner. + In Business Address Services, you can specify a standard communication method that can be used by programs to determine the means of communication for sending messages.One business partner wants all messages by fax, another by e-mail.The application context can restrict the possible methods of communication. For example, invitations should perhaps only be sent by post because of enclosures, whereas minutes can be sent by post, fax or e-mail.Communication strategies can be defined for this purpose and applied in application contexts. + + + + + In some countries, the region forms part of the address. The meaning depends on the country. + The automatic address formatting function prints the region in addresses in the USA, Canada, Italy, Brazil or Australia, and the county in Great Britain.For more information, see the examples in the documentation on the Address Layout Key.Meaning of the regional code in ...Australia -> ProvinceBrazil -> StateCanada -> ProvinceGermany -> StateGreat Britain -> CountyItaly -> ProvinceJapan -> PrefectureSwitzerland -> CantonUSA -> State + + + + + Street name as part of the address. + The street name is saved, redundantly in upper case in another database field, for search help purposes.There are other fields for address parts which can be printed above or below the street. See Print the Street address.The house number and other supplements are usually maintained in their own fields. See Formatting the Street line. + + + + + Additional address field which is printed above the Street line. + The Street address contains two lines above the street and two lines below the street.See Print the Street address.This field is not always automatically printed, as it was subsequently added to the address structure.The print program or form may need to be adjusted.This exception applies to the following fields:Street2, Street3, Street4, Street5, c/o name, and to all address fields added after Release 4.5. + + + + + Additional address field which is printed below the Street line. + The Street address contains two lines above the street and two lines below the street.See Print the Street address. + + + + + Specifies the tax jurisdiction. + + + + + + Sales and distribution: + Regional zone of Goods recipient.Purchasing:Regional zone of supplier.You can define regional zones to suit the requirements of your own business and country.Sales and distributionthe system automatically proposes a suitable route by using the transportation zone of the goods recipient in combination with other information about the delivery, such as theCountries of origin and destinationShipping conditionsTransportation groupIn the USA, for example, you can define regional zones to correspond to the US postal zip codes. + + + + + Address number from an external system or a legacy system + If the current address has a different number in an external system, you can save this number here for information purposes.In direct input you are able to maintain an address for a business partner by stating the external address number. If your business partner data is maintained in a legacy system, you can thus transmit changes to a BP address to the SAP system without having to know the SAP address number in the legacy system. + + + + + + + + + + + + + + + + + Key identifying a business partner in the SAP system. The key is unique within a client. + + + + + + Key identifying a business partner's bank details. + Enter a bank details ID for each separate set of bank details for a business partner.Business Partner: H. MillerBD-ID Fin.institution Acct no. 0001 Chemical Bank, NYC 56234560002 Chemical Bank, NYC 56231220003 First Bank of Pittsburgh ...Business partner: T.Wolsey and Co.BD-ID Fin.institution Acct no.GIR0 Citibank, Charleston ...GIR1 Chemical Bank, NYC ... + + + + + Identifies the country in which the bank is based. + The country key determines according to which rules the remaining bank data (for example, bank number and bank account number) is checked. + + + + + The name under which the bank operates. + + + + + + The bank key (under which the bank data is stored in the appropriate country) is specified in this field. + The country-specific meaning of this bank key is specified when defining country key.Normally banks have a bank number, which then also appears in the control data of the bank.In certain countries the bank account number assumes this function; in such a case there would be no bank numbers, the bank details are then under the account number.For data medium exchange it can be useful to be able create banks for foreign business partners without a bank number, even if the country in question has bank numbers. In such cases the bank key can be assigned internally.If the bank data is under another key, such as the SWIFT code for example, numbers can also be assigned externally. + + + + + Uniquely identifies a bank throughout the world. + SWIFT stands for Society for Worldwide Interbank Financial Telecommunication.BIC stands for Bank Identifier Code.This globally unique code can be used in international payment transactions to identify the bank without the need to specify an address or bank number. Specification of the SWIFT code/BIC is mainly relevant for automatic payment transactions. + + + + + Brazil, France, Spain, Portugal and Italy + The field contains a check key for the combination bank number and bank account number.USAIn USA this field is used to differentiate between a savings and a current account (if no value is entered, the default value 01 is used).01 Current account02 Savings account03 Loan account04 General ledgerJapanIn Japan this field specifies the type of account. This information is is copied from the payment medium print program into payment medium. The following is an example of the account types used:01 FUTSU (similar to a savings account)02 TOUZA (similar to a current account)04 CHOCHIKU (similar to an investment account)09 Other types of bank accountsSouth AfricaIn South Africa this field specifies the type of account. The information entered here is forwarded to the bank that carries out the payment order. The following account types are permitted in ABC format:01 Current (Cheque) Account02 Savings Account03 Transmission Account04 Bond Account06 Subscription Share AccountArgentinaIn Argentina this field specifies the type of account:CC Current Account (Cuenta corriente)CA Saving Account (Caja de ahorro)CE Special Saving Account (Caja de ahorro especial)CS Salary Account (Cuenta sueldos)VenezuelaIn Venezuela this field specifies the type of account:CC Checking Account (Cuenta corriente)CA Saving Account (Cuenta de ahorro)CE Special Saving Account (Cuenta de ahorro especial)CS Salary Account (Cuenta sueldos)MexicoIn Mexico this field contains a two-digit key for classifying the bank account (for example, as a savings or current account). This key have different definitions, depending on the bank.NoteFor countries that are not listed here, this field can be used for account-specific information. + + + + + Here you can enter another name that the payment program can use if the name of the account holder is not the same as the name of the Business Partner. + + + + + + + + + A uniform standardized ID number for representing bank details that is in accordance with the ECBS (European Committee for Banking Standards). An IBAN has a maximum of 34 alphanumeric characters and is a combination of the following elements: + Country key of the bank (ISO code)Two-digit check numberCountry-specific account number (in Germany this consists of the bank number and account number, in France the bank number, account number and check key).The IBAN not only makes international payments easier, in some countries it has advantages for domestic payments as well. Depending on the country, it can mean advantages for value and fees.The IBAN can be maintained in parallel with the bank details but does not replace them. It is stored under the master data of the business partner and can then be used when creating the payment medium.Since it is only the bank that has the account that may generate the IBAN corresponding to an account number, the SAP system only generates a proposal. You can confirm or change this proposal. If no proposal is generated, enter the IBAN manually.An IBAN in Belgium may look like this:Electronic Form:BE62510007547061Printed form, as it would appear on an invoice:IBAN BE62 5100 0754 7061 + + + + + + This field contains the number under which the account is managed at the bank. + + + + + + Additional details for the bank details of the business partner. + In some countries the data for the bank details of the business partner (bank number, bank account number, name of the account holder) have to supplemented by other details in order to be able to use certain payment processes. This supplementary details are defined here.If additional data is required for the bank details for payment transactions in your country (see the following examples), enter the reference information.If for an automatic debit the bank requires the reference number of the collection authorization in Norway or Great Britain, specify this number here.In Great Britain when making payments to an account in a 'Building Society' you must specify which number payment recipient has. These details must be defined in the reference field, whereas the fields Bank Key and Account Number are to be used for the bank details of the 'Building Society'.In Great Britain when entering a building society account number, the name of the building society should also be maintained in the system. + + + + + States that the bank has collection authorization from the business partner for the account. + Set this indicator if the bank has collection authorization.Note for Accounts Receivable (FI-AR)If this indicator is not set, there is no bank collection.Note for Contract Accounts Receivable and Payable (FI-CA)This indicator is not relevant. + + + + + Name of the city as a part of the address. + + + + + + You can use authorization groups to stipulate which business partners a user is allowed to process. + Use the following authorization object:'Business partners: authorization groups' (B_BUPA_GRP).The system only checks this authorization if you made an entry in the "Authorization group" field for the business partner. Otherwise, any user may process the business partner. + + + + + + + + + + + + + The business partner relationship number is an internal number that identifies the business partner relationship set. + + + + + + Key identifying a business partner in the SAP system. The key is unique within a client. + + + + + + Key identifying a business partner in the SAP system. The key is unique within a client. + + + + + + + + States whether the relationship is a standard relationship. + If several relationships of the BP relationship category contact person have been defined for, you can set the indicator standard relationship for one of these relationships.A relationship that is marked as a standard relationship can be used whenA certain scenario automatically selects a contact personThe contact person responsible is not knownYou can give this indicator to only one business partner relationship of a BP relationship category for a particular period. Another relationship of the same relationship category can be indicated as the standard relationship only if the periods for the relationship do not overlap or coincide. + + + + + A relationship may exist between two business partners. The business partner relationship category characterizes the features of the relationship. + A distinction is made between a one-way and an undirected business partner relationship category. In a one-way relationship category, the relationship extends from one partner to another, but not vice versa.Marriage (undirected)Employee (one-way)Contact person (one-way) + + + + + + + + + + + + + Key identifying a business partner in the SAP system. The key is unique within a client. + + + + + + Function that a business partner takes on, depending on a business transaction. + You can define business partner roles along with their attributes in Customizing.You can create an alphanumeric, 6-digit key for the BP role. You can also choose a title as the short form and a description as the long form for the role text.Screen control in the dialog takes place by assigning a BP view.A program can access specific business partner roles for a business partner using thebusiness partner role category . The role categories are also in the TB003 table. + + + + + + + You can use authorization groups to stipulate which business partners a user is allowed to process. + Use the following authorization object:'Business partners: authorization groups' (B_BUPA_GRP).The system only checks this authorization if you made an entry in the "Authorization group" field for the business partner. Otherwise, any user may process the business partner. + + + + + + + + + + + Key identifying a business partner in the SAP system. The key is unique within a client. + + + + + + Specifies the tax number category. + + + + + + Specifies the tax number. + + + + + + Specifies the tax number. + You can enter up to 60 characters in this field. + + + + + You can use authorization groups to stipulate which business partners a user is allowed to process. + Use the following authorization object:'Business partners: authorization groups' (B_BUPA_GRP).The system only checks this authorization if you made an entry in the "Authorization group" field for the business partner. Otherwise, any user may process the business partner. + + + + + + + + + + Gives an alphanumeric key, which clearly identifies the customer or vendor in the SAP system. + + + + + + The authorization group allows extended authorization protection for particular objects. The authorization groups are freely definable. The authorization groups usually occur in authorization objects together with an activity. + + + + + + Indicates if the processing of billing documents is blocked for the customer in all sales areas (company-wide, for example). + You can define different kinds of block, according to the needs of your organization. You can, for example, automatically block the processing of all credit memos to a certain customer, pending manual approval. + + + + + Name with which the user who entered the master record was logged on in the R/3 System. + + + + + + Date on which the master record, or the part of the master record being viewed, was created. + + + + + + The account group is a classifying feature within customer master records. The account group determines: + in which number range the customer account number should be;whether the number is assigned by the user or by the system;which specifications are necessary or possible in the master record. + + + + + Specifies a classification of the customer (for example, classifies the customer as a bulk purchaser). + The classifications are freely definable according to the needs of your organization. + + + + + + + Indicates if delivery processing is blocked for the customer in all sales areas (company-wide, for example). + You can define different kinds of block, according to the needs of your organization. You can, for example, automatically block all deliveries to a certain customer for credit reasons. + + + + + Denotes a natural person. + In the following countries, the system needs to know whether the taxpayer is a legal or natural person so that it can check the tax numbers correctly:BrazilBulgariaColombiaCroatiaGreeceItalyMexicoPeruSloveniaThailandUkraineThe flag is also used in conjunction with the Statement of Payments to Natural Persons report, as used in the Czech Republic and in Slovakia. This report only covers customers and vendors for whom you have set this indicator.In South Korea, it is used in conjunction with the Generic Withholding Tax Reporting program. + + + + + Indicates if sales order processing is blocked for the customer in all sales areas (company-wide, for example). + If you block sales order processing, the block counts for the following partner functions of the customer:Sold-to partyShip-to partyPayerIf you want to process an order where the ship-to party differs from the sold-to party, and the ship-to party is blocked, you cannot process the order.You can define different kinds of block, according to the needs of your organization. You can, for example, automatically block all free of charge deliveries and credit memo requests for a certain customer, pending manual approval before further processing can take place. + + + + + Indicates that the account is blocked for posting for all company codes. + If you set this indicator, the system prevents users from posting items to this account and issues an error message to inform them that the account is blocked. + + + + + Specifies an alphanumeric key that uniquely identifies the supplier in the SAP system. + + + + + + If the customer or the vendor belongs to a group, you can enter a group key here. The group key is freely assignable. + If you create a matchcode using this group key, group evaluations are possible. + + + + + Account number of another master record in which the official address is stored. This address is used, for example, for tax reports to the tax authorities in Italy. + + + + + + An industry is a distinct group of companies with the same basic business activity. The industry key is used in selecting data for evaluations (for example, a vendor master data list). You can specify industries such as trade, banking, service, manufacturing, health care, public service, media and so on. + The industry field belongs to the general data area of customer and vendor master records. + + + + + Specifies the code that uniquely identifies the industry (or industries) of the customer. + Depending on the standards your organization uses (for example, Standard Industry Codes (SIC)), enter the appropriate code. You can assign more than one industry code to a customer by choosing Create more. + + + + + Specifies an additional code that identifies the industry (or industries) of the customer. + Depending on the standards your organization uses (for example, Standard Industry Codes (SIC)), enter the appropriate code. + + + + + Specifies an additional code that identifies the industry (or industries) of the customer. + Depending on the standards your organization uses (for example, Standard Industry Codes (SIC)), enter the appropriate code. + + + + + Specifies an additional code that identifies the industry (or industries) of the customer. + Depending on the standards your organization uses (for example, Standard Industry Codes (SIC)), enter the appropriate code. + + + + + Specifies an additional code that identifies the industry (or industries) of the customer. + Depending on the standards your organization uses (for example, Standard Industry Codes (SIC)), enter the appropriate code. + + + + + Here you enter the first 7 digits of the international location number. + The International Location Number (ILN) is assigned (in Germany by the Centrale for Coorganisation GmbH)) when a company is founded. It consists of 13 digits, the last digit being the check digit. There are two categories of location numbers:Participants who only need an ILN to cleary and unmistakably identify themselves for communication with the business partner are given a category 1 ILN. This cannot be used to identify articles by means of EAN.Participants who wish to assign the location numbers for their own enterprise areas are given a category 2 ILN. For a category 2 ILN, digits 1 to 7 are described as basis number. This is used as basis for the creation of article numbers (EAN). + + + + + Specifies a regional division according to the market categories created by the A. C. Nielsen company. + By allocating a Nielsen division, you can use the services of the Nielsen Institute to create a market analysis of your customers. + + + + + Classification of companies according to tax aspects. + + + + + + Specifies the tax number. + Enter the appropriate tax number:Country Tax NumberArgentina CUIT number or CUIL numberBelgium Enterprise numberBrazil CNPJ numberBulgaria Unified identification codeChile RUT numberChina VAT registration number (shui wu deng ji hao)Colombia NIT numberCroatia Legal persons: company identification numberNatural persons: JMBG numberCzech Republic DIC numberFrance SIRET numberGreece Personal IDHungary Tax numberItaly Fiscal codeKazakhstan RNN (obsolete)Mexico RFC numberNetherlands SI registration number (Aansluitnummer UWV) of chain- liability vendorNorway VAT numberPeru RUC numberPhilippines Taxpayer identification number (see below)Poland NIP numberPortugal NIF numberRomania Tax numberRussia INNSlovakia DIC numberSlovenia Tax numberSouth Korea Natural persons: Personal identification numberLegal persons: Corporation IDSpain NIF numberSwitzerland UID numberTaiwan GUI registration numberThailand Personal IDTurkey Name of business partner's tax officeUkraine Taxpayer identification numberUnited Kingdom Company registration numberUnited States Social security numberVenezuela RIF numberIn the Philippines, enter the taxpayer identification number with a V or N at the end, as follows:If the business partner is liable to VAT: 999-999-999-999VIf the business partner is not liable to VAT: 999-999-999-999N + + + + + Specifies the tax number. + Enter the appropriate tax number:Country Tax NumberArgentina NIP number or CM numberBelgium VAT numberBrazil CPF numberBulgaria Legal persons: tax numberNatural persons: personal IDCroatia OIB number Czech Republic ICO numberFrance SIREN numberGreece AFM numberIndia TINItaly VAT numberKazakhstan BC (Beneficiary Code)Netherlands BSN numberRussia OKPO codeSlovakia ICO numberSouth Korea VAT registration numberSweden Organization registration numberSwitzerland VAT numberTaiwan Tax registration numberUkraine Legal persons: USREOU numberNatural persons: SRNP numberTurkey Tax numberUnited Kingdom NI numberUnited States Employer identification numberVenezuela NIT number + + + + + Specifies the tax number. + Enter the tax number that applies:Country Tax numberArgentina Withholding agent numberBrazil State tax numberBulgaria Social security numberMexico CURP numberKazakhstan BINNetherlands Tax registration number (Loonbelastingnummer) of the chain-liability vendorRussia KPP numberThailand Tax ID Ukraine VAT registration number + + + + + Specifies the tax number. + Enter the appropriate tax number:Country Tax NumberBrazil Municipal tax numberKazakhstan IINRussia OFK number (for public bodies only) + + + + + Kazakhstan + Specifies the certificate of registration as VAT payer in the following format: XXXXXYYYYYYYZZZZZZZZ, where: XXXXX is the certificate serial number, YYYYYYY is the certificate number and ZZZZZZZZ is the date of certificate issue. + + + + + Taxes in Argentina: + The format and the check of tax number 1 depend on the two-digit tax number type.The tax number type is an identification type for tax in Argentina (for example, 80 for CUIT) and is used for the DGI tax report. + + + + + VAT registration number (VAT reg.no.) of the customer, vendor or your company code. + The VAT registration number is used within the EU for tax-exempt deliveries for the "EC sales list". The check rules are defined for each EU country and cannot be changed. + + + + + Indicates that all data in this master record is to be deleted. + To delete this data, you have to run the archiving program for Accounts Receivable or Payable. This program will archive all master records marked for deletion provided that there is no dependent data in them.Deletion flags can also be used in the program for deleting master data. You should, however, run this program only to delete test data prior to production startup. + + + + + + + + + + + + + Gives an alphanumeric key, which clearly identifies the customer or vendor in the SAP system. + + + + + + The company code is an organizational unit within financial accounting. + + + + + + Contains settings that control how the system handles differences between the invoice amount and the amount received from a customer or the amount paid to a supplier. A tolerance group is unique within a company code. + + + + + + This field contains the account number the company is listed under at the customer. + + + + + + Identification code for the accounting clerk. + The name of the accounting clerk defined by this identification code can be used in the payment program for correspondence and reporting (for example, open item lists). + + + + + + + + + Account number of the customer for whom automatic payment transactions are to be carried out.The account number is only needed if bank collections are not to be made via the customer who owes the receivables. The same applies to refunds of payables.The specification in this field only applies to this company code. There is another field in which you can enter an alternative payee for all company codes. If both fields are filled, the specification for the company code has priority. + + + + + The authorization group allows extended authorization protection for particular objects. The authorization groups are freely definable. The authorization groups usually occur in authorization objects together with an activity. + + + + + + Indicator which specifies at what intervals the collective invoices are to be created for the customer. + + + + + + Internal memo of the accounting department. + The memo serves only as information on special features of the customer/vendor. + + + + + This field contains the account number of the head office. + This account number is only specified for branch accounts. All postings for which the account number of the branch is specified, are automatically posted to the head office account. The account number of the branch affected is noted in the line items.No line items or balances are managed in the branch account. + + + + + Indicates that during automatic payment transactions clearing is made with the corresponding vendor account, and that during manual clearing procedures, the items of that vendor account are also selected. + To use this function in automatic payment transactions, you have toenter the vendor account number in the customer master record,enter the customer account number in the vendor master record, andselect the "Clearing with customer" indicator in the vendor master record.If you set this indicator, the system will also include items of the vendor account in customer dunning. + + + + + All bank data is determined using this key. + + + + + + Enter an interest calculation indicator here if the account is to be included in automatic interest calculation. + + + + + + The date in this field displays the last time the interest calculation program processed this account. This is generally the upper limit of the last interest run. + Generally, this date is automatically maintained by the program (batch input). A manual entry in this field should only be made if an error has occurred or when implementing the interest calculation. + + + + + An entry in this field determines the intervals (in months) at which interest is to be calculated automatically for this account (account balance interest calculation). The interest calculation frequency is added to the date of the last interest calculation. + Date of last interest calculation: 3/31.+ 01 month interest calculation frequency= 4/30 upper limit for the current interest runThe calculation period specified as a report parameter determines whether an account is included in an interest run.The upper limit of the interest run is calculated as in the above example and compared with the upper limit of the calculation entered in the interest run (report parameter). If the calculated upper limit is after the calculation period, the account is not included in interest calculation.If you maintain the interest calculation frequency in the account master record, this entry is used to calculate the upper limit. If not, the interest calculation frequency entered for the interest indicator is used. + + + + + Indicates that payment transactions and dunning notices are created for the branch. + Normally automatic payment transactions and dunning notices are created for the head office.NoteSelect this indicator only if this account is a head office account. + + + + + If this indicator is set, every customer/vendor open item is paid separately during automatic payment transactions. This means that open items are not grouped together for payment. + + + + + + Indicates the layout rule for the Allocation field in the document line item. + The system uses a standard sort sequence for displaying line items. Among other things, it sorts the items according to the content of the Allocation field. This field can be filled either manually or automatically (by the system) when a document line item is entered.For this purpose, the system requires rules that determine which information is to be taken from the document header or from the document line item and placed in the field. The rules can be stored in the master record of an account which enables you to determine the standard sort sequence on an account-specific basis.NoteField information from another document line item cannot be adopted into the field of a particular item. + + + + + Block key (enqueue key) that is used to block an open item or an account to payment transactions. + You can use the block key as described below.Automatic Payment TransactionsIn automatic payment transactions, the block takes effect when it is entered in the system as follows:In the master recordIn the documentIf you enter the block in the master record then all open items for this account are contained in the exception list.The following block keys have a special meaning in the master record:The block key * has the effect that all items of the account are skipped in automatic payment transactions.The block key + has the effect that all items are skipped in which a payment method was not entered explicitly.The block key A is always set automatically when a down payment is entered. Therefore, you must not delete the block key A or use it for other purposes.Whether a block key can be set or removed in payment proposal processing depends on the attribute Changeable in payment proposal of the block key.Manual PaymentsManual payments are only affected by a block key in the document if you set the attribute Blocked for manual payments in the block key.A block key that was set in the master record does not have any effect on manual payments. You can have the system issue a warning message in that case. To do so, you have to make system settings. Set up message 671 of work area F5 in message control accordingly. + + + + + List of payment methods which may be used in automatic payment transactions with this customer/vendor if you do not specify a payment method in the item to be paid. + If you do specify a particular payment method in the item to be paid, this specification has priority over the specifications in the master record. You may also specify payment methods in the item which are not listed in the master record. + + + + + Key for defining payment terms composed of cash discount percentages and payment periods. + It is used in sales orders, purchase orders, and invoices. Terms of payment provide information for:Cash managementDunning proceduresPayment transactionsData can be entered in the field for the terms of payment key in various ways as you enter a business transaction:In most business transactions, the system defaults the key specified in the master record of the customer/vendor in question.In some transactions (for example, credit memos), however, the system does not default the key from the master record. Despite this, you can use the key from the customer/vendor master record by entering "*" in the field.Regardless of whether or not a key is defaulted from the master record, you can manually enter a key during document entry at:item level in sales ordersheader level in purchase orders and invoicesMaster records have separate areas for Financial Accounting, Sales, and Purchasing. You can specify different terms of payment keys in each of these areas. When you then enter a business transaction, the application in question will use the key specified in its area of the master record. + + + + + This indicator specifies that the customer/vendor should be sent all payment advice information by EDI. + + + + + + Indicates that the account is blocked for posting in the specified company code. + If you set this indicator, the system prevents users from posting items to this account and issues an error message to inform them that the account is blocked. + + + + + The reconciliation account in G/L accounting is the account which is updated parallel to the subledger account for normal postings (for example, invoice or payment). + For special postings (for example, down payment or bill of exchange), this account is replaced by another account (for example, 'down payments received' instead of 'receivables').The replacement takes place due to the special G/L indicator which you must specify for these types of postings. + + + + + Indicator that the payment history of the customer is to be recorded. + The amount and number of payments are then recorded per calendar month, as well as the average days in arrears.Information about cash discount payments and net payments is recorded separately.The indicator should not be set for one-time accounts and accounts which are paid automatically (bank collection or bank bill in Germany, bill of exchange payment request in France).You can only carry out evaluation of the payment history, for example, with the report for customer evaluation with OI listing, if you have selected this field. + + + + + Name or identification code of the accounting clerk at the customer. + + + + + + Indicates that the company code data in this master record is to be deleted. + To delete this data, you have to run the archiving program for Accounts Receivable or Payable. This program will archive all master records marked for deletion provided that there is no dependent data in them.This deletion flag cannot be used in the program that deletes master data. You should, however, run this program only to delete test data prior to production startup. + + + + + The account group is a classifying feature within customer master records. The account group determines: + in which number range the customer account number should be;whether the number is assigned by the user or by the system;which specifications are necessary or possible in the master record. + + + + + + + + + + + + + + Gives an alphanumeric key, which clearly identifies the customer or vendor in the SAP system. + + + + + + The company code is an organizational unit within financial accounting. + + + + + + The dunning area represents an organizational entity that is responsible for dunning. The dunning areas represent a sub-structure of the company codes. + If different responsibilities or different dunning procedures exist within a company code, you can set up corresponding dunning areas.All dunning notices are made separately according to dunning areas, and if necessary with different dunning procedures.The dunning area must be noted in the line items. As long as documents are copied from preliminary work areas (billing documents), the dunning area can be derived from details such as division or sales area, if necessary. + + + + + Key which reflects the reason for a dunning block indicator. + + + + + + Number that specifies how often an item or account has been dunned. + The business partner has received the dunning level from the last dunning run.If you use dunning areas, it is the dunning level that the business partner received from the last dunning run in the dunning area assigned.The dunning program sets the dunning level automatically when the customer or vendor receives a dunning notice. + + + + + This field contains the key for the dunning procedure to be used. + + + + + + Account number of the customer who is to be the recipient of the dunning letters. + The account number is only needed if dunning letters are not sent to the customer who owes the receivables. + + + + + Date on which the last dunning notice was made. + + + + + + Date on which a legal dunning procedure was initiated. + The printing of dunning notices in the legal dunning procedure generates an internal notice about any further account movements. A dunning notice is not created for the customer.If the Legal dunning procedure field in the master record contains a date, this means that the account is involved in a legal dunning procedure. The relationship between this date and the dunning date does not affect how the account is processed.The printing of account movements in the legal dunning procedure differs from the normal printing of dunning notices as follows:You must specify a separate form for your dunning procedure in Customizing. For more information, see Customizing (IMG) under Dunning Forms.The dunning program also displays text element 520 "Legal dunning procedure". This makes it possible to display the date of the legal dunning procedure from the master record.The program also displays the documents blocked for dunning and those with a payment method (automatic debit, bank direct debit).Although dunning notices are printed, the dunning level does not change in the master record or in the items. New dunning level = old dunning level.The program only updates the date of the last dunning run.Enter the date manually. + + + + + Identification code for the accounting clerk dealing with dunning letters. + Using this identification code, the accounting clerk whose name is printed on the dunning letters is determined.If this field is not filled, then the entry from the Accounting clerk field is used. + + + + + The authorization group allows extended authorization protection for particular objects. The authorization groups are freely definable. The authorization groups usually occur in authorization objects together with an activity. + + + + + + The account group is a classifying feature within customer master records. The account group determines: + in which number range the customer account number should be;whether the number is assigned by the user or by the system;which specifications are necessary or possible in the master record. + + + + + + + + + + + + + Gives an alphanumeric key, which clearly identifies the customer or vendor in the SAP system. + + + + + + An organizational unit responsible for the sale of certain products or services. The responsibility of a sales organization may include legal liability for products and customer claims. + You can assign any number of distribution channels and divisions to a sales organization. A particular combination of sales organization, distribution channel, and division is known as a sales area. + + + + + The way in which products or services reach the customer. Typical examples of distribution channels are wholesale, retail, or direct sales. + You can maintain information about customers and materials by sales organization and distribution channel. Within a sales organization you can deliver goods to a given customer through more than one distribution channel.You can assign a distribution channel to one or more sales organizations. If, for example, you have numerous sales organizations, each sales organization may use the "Wholesale" distribution channel.For each combination of sales organization and distribution channel, you can further assign one or more of the divisions that are defined for the sales organization. You can, for example, assign "Food" and "Non-food" divisions to the "Wholesale" distribution channel. A particular combination of sales organization, distribution channel, and division is known as a sales area. + + + + + A way of grouping materials, products, or services. The system uses divisions to determine the sales areas and the business areas for a material, product, or service. + A product or service is always assigned to just one division. From the point of view of sales and distribution, the use of divisions lets you organize your sales structure around groups of similar products or product lines. This allows the people in a division who process orders and service customers to specialize within a manageable area of expertise.If a sales organization sells food and non-food products through both retail and wholesaledistribution channels each distribution channel could then be further split into food and non-food divisions. + + + + + This field contains the account number your company is listed under at the customer or vendor. + + + + + + The authorization group enables you protect access to certain objects. + In order to carry out a specific activity, the user must have authorization for the combination of the activity and the authorization group. + + + + + Indicates if further billing activities are blocked for the customer. The block applies throughout the specified sales area. + If you enter a blocking indicator, billing that is already underway is continued. However, you cannot process the document further.Enter one of the values predefined for your system. If you want to block billing for a customer throughout an entire sales organization, you must enter a blocking indicator for each sales area in which the sales organization is defined.You can block billing for a customer if, for example, there are credit-related or legal problems to be resolved. + + + + + Indicates whether a sales order must be delivered completely in a single delivery or whether the order can be partially delivered and completed over a number of deliveries. + + + + + + Customer's currency for a sales area. This currency will be used to settle the customer's charges for the given sales organization. + + + + + + + The account assignment group to which the system automatically posts the sales document. + The system uses the account assignment group as one of the criteria during the automatic determination of revenue accounts.The system automatically proposes the account assignment group from the customer master record of the payer. You can change the default value in the sales document or the billing document. + + + + + Identifies a particular group of customers (for example, wholesale or retail) for the purpose of pricing or generating statistics. + + + + + + Key for defining payment terms composed of cash discount percentages and payment periods. + It is used in sales orders, purchase orders, and invoices. Terms of payment provide information for:Cash managementDunning proceduresPayment transactionsData can be entered in the field for the terms of payment key in various ways as you enter a business transaction:In most business transactions, the system defaults the key specified in the master record of the customer/vendor in question.In some transactions (for example, credit memos), however, the system does not default the key from the master record. Despite this, you can use the key from the customer/vendor master record by entering "*" in the field.Regardless of whether or not a key is defaulted from the master record, you can manually enter a key during document entry at:item level in sales ordersheader level in purchase orders and invoicesMaster records have separate areas for Financial Accounting, Sales, and Purchasing. You can specify different terms of payment keys in each of these areas. When you then enter a business transaction, the application in question will use the key specified in its area of the master record. + + + + + A grouping of customers who share the same pricing requirements. + You can define price groups according to the needs of your organization and create pricing records for each group. You can, for example, define a group of customers to whom you want to give the same kind of discount. You can assign a price group to an individual customer either in the customer master record or in the sales document.The system can propose the price group from the customer master record. You can change the proposed value manually in the sales document at both header and item level. + + + + + Determines which pricing procedure the system should apply when you create a sales document for the customer. + You can define different pricing procedures for your system. A pricing procedure determines the type and sequence of conditions that the system uses for pricing in, for example, a sales order. + + + + + Indicates if further delivery processing is blocked for the customer. The block applies throughout the specified sales area. + If you enter a blocking indicator, delivery processing that is already underway is continued. However, no new processing can take place.Enter one of the values predefined for your system. If you want to block delivery processing for a customer within a particular sales organization, you must enter a blocking indicator for each sales area in which the sales organization is defined.You can block delivery processing for a customer if, for example, there are credit-related or legal problems to be resolved. + + + + + The delivery priority assigned to an item. + You can assign delivery priority to either a particular material or to a combination of customer and material. When you process deliveries collectively, you can use delivery priority as one of the selection criteria. + + + + + Commonly used trading terms that comply with the standards established by the International Chamber of Commerce (ICC). + Incoterms specify internationally recognized procedures that the shipper and the receiving party must follow for the shipping transaction to be completed successfully.If goods are shipped through a port of departure, the appropriate Incoterm might be: FOB ("Free On Board"). You can provide further details (for example, the name of the port) in the secondary Incoterm field: FOB Boston, for example. + + + + + Provides additional information for the Incoterms. This field is only available for C-Clauses (if customized appropriately). Note the following for the incoterms versions below: + No Version:This field is disabledIncoterm Version 2000This field is disabled as part of standard delivery unless a customer decides to enable it by the way of Customizing for Sales and Distribution under Master Data -> Business Partners -> Customers -> Billing Document -> Incoterms -> Map Incoterms to Versions.Incoterm Version 2010For this version, the field represents:Sea and inland waterway transport - Port of DestinationAny mode of transport - Place of Destination2010 Incoterms are divided as follows:Group 1: Rules for any mode or modes of transport (including by vessel)Incoterms Incoterms Description Location 2CPT Carriage Paid To Place of DestinationCIP Carriage & Insurance Paid To Place of DestinationGroup 2: Rules for sea and inland waterwaysIncoterms Incoterms Description Location 2CFR Cost & Freight Port of DestinationCIF Cost Insurance & Freight Port of Destination + + + + + An incoterms version is an edition containing a list of international terms for transportation that is defined by the International Chamber of Commerce (ICC). + + + + + + Provides additional information for the primary Incoterm. For Incoterms 2010, this field represents: + 1. For sea and inland waterway transport - Port of Shipment2. For any mode of transport - Place of Delivery 2010Incoterms are divided as follows:Group 1: Rules for any mode or modes of transport (including by vessel)Incoterms Incoterms Description Location 1 EXW Ex Works Place of DeliveryFCA Free Carrier Place of DeliveryCPT Carriage Paid To Place of DestinationCIP Carriage & Insurance Paid To Place of DestinationDAF Delivered at Frontier Place of DeliveryDDP Delivered Duty Paid Place of DestinationDDU Delivered Duty Unpaid Place of DestinationGroup 2: Rules for sea and inland waterwaysIncoterms Incoterms Description Location 1 FAS Free Alongside Ship Port of ShipmentFOB Free On Board Port of ShipmentCFR Cost & Freight Port of DestinationCIF Cost Insurance & Freight Port of DestinationDEQ Delivered Eq Quay (Duty Paid) Port of DestinationDES Delivered Ex Ship Port of DestinationIf the primary incoterm is specified as FOB “Free on Board”, the second field provides details of the port from which the delivery leaves, such as FOB Boston. + + + + + Indicates that all data in the master record will be deleted for the specified sales area. Before the deletion is made, the system checks for dependent data that would prevent the deletion. + + + + + + Additional information for the primary Incoterm. + If the primary Incoterm is, for example, FOB ("Free on Board"), then the second field provides details of the port from which the delivery leaves (for example, "FOB Boston"). + + + + + Identifies the calendar that determines the schedule of billing dates for the customer. + If, for example, a customer wants to consolidate the invoices you send out, you can predefine the billing schedule in a calendar in the system. During billing, the system automatically proposes the appropriate billing date from the calendar.The system proposes the billing schedule from the customer master record of the payer. You can change the value manually in the sales document. + + + + + The probability (expressed as a percentage) of the customer confirming the inquiry or quotation item as part of a sales order. + The system combines the probability factors from the sales document type and from the customer master record of the sold-to party.If probability is 80% for the sales document type and 50% in the customer master record, the system combines the two values. In this case, the system takes 50% of 80% and proposes 40% for the item.The system proposes the probability. You can change the value manually for the item.You can generate requirements from quotations. Accordingly, the probability of quotation items affects how requirements are passed on. For example, a quotation for 100 pieces and a probability of 50% will generate requirements for 50 pieces. + + + + + Indicates whether you are allowed to combine orders during delivery processing. + The system proposes the indicator from the customer master record. You can change the value manually in the sales document at both header and item level. + + + + + Indicates if further sales order processing is blocked for the customer. The block applies throughout the specified sales area. + You can define blocks according to the needs of your organization. If you enter a blocking indicator, sales order processing that is already underway is continued. However, no new processing can occur.Enter one of the values predefined for your system. If you want to block sales order processing for a customer within a particular sales organization, you must enter a blocking indicator for each sales area in which the sale organization is defined.You can block sales order processing for a customer if, for example, there are credit-related or legal problems to be resolved. + + + + + Specifies whether the customer requires full or partial delivery for the item. + You use this field to control partial deliveries at the item level. If the customer allows partial delivery, you can choose from different partial delivery options. For example, you can specify whether the customer allows you to make one delivery attempt only on the requested delivery date or whether unlimited delivery attempts are possible.When partial delivery indicator 'D' is set, the order can never have status 'fully delivered'. You must complete each item by entering a reason for rejection. This could be applied to scheduling agreements, for example.You can enter a value in this field only if the customer allows partial deliveries for the entire sales document. + + + + + Identifies a price list or other condition type (for example, a surcharge or discount). + You can define price list types according to the needs of your own organization. Price list types can be grouped according to:the kind of price list (for example, wholesale or retail)the currency in which the price appearsthe number of the price list typeYou can use price list types to apply conditions during pricing or to generate statistics.In the customer master record, enter one of the values predefined for your system. The system proposes the value automatically during sales order processing. You can change the value manually in the sales document header. + + + + + A group of sales people who are responsible for processing sales of certain products or services. + By using sales groups you can designate different areas of responsibility within a sales office. When you generate sales statistics, you can use the sales group as one of the selection criteria.If sales office personnel service both retail and wholesale markets, you can assign a sales group to each market.You assign each salesperson to a sales group in his or her user master record. You assign each customer to a particular sales group in the customer's master record. + + + + + A physical location (for example, a branch office) that has responsibility for the sale of certain products or services within a given geographical area. + When you create sales statistics, you can use a sales office as one of the selection criteria. When you print out order confirmations, you can include the address of the sales office.You can assign each customer to a sales office in the customer master record.Within a sales office you can establish sales groups (for example, departments) with specific sales responsibilities. Each person who works in the sales office can be assigned to a sales group in his or her user master record. Each customer can also be assigned to a particular sales group in the customer master record. + + + + + General shipping strategy for the delivery of goods from the vendor to the customer. + You can define shipping conditions in your system which correspond to the requirements of your company. You can specify a shipping condition in the customer master and in the vendor master.Shipping point determination (outbound delivery):The loading group, the plant and the shipping condition determine the shipping point that will be proposed by the system.Route determination (outbound delivery):Apart from the country and the geographical region of the shipping point, the ship-to party and the transportation group, the shipping condition determines the route that the system proposes in the order for the delivery of the goods. In the delivery, the route proposal also takes the weight group into account.A particular customer always requires immediate delivery. You enter the appropriate shipping condition into the customer master record. This means that when you process orders for this customer, the system automatically proposes the express mail room as a shipping point and the quickest way to the airport as a route.If a shipping condition has been assigned to a sales document type in Customizing, this condition will be proposed by the system in the corresponding sales document. If there is no assignment, the system copies the relevant data from the corresponding customer master record of the sold-to party. You cannot change this value during delivery processing. The shipping condition will not be copied from the delivery into the shipment. The shipping condition is one of several criteria for selecting deliveries when you create a shipment. You can enter a shipping condition manually in the shipment where it only serves as a characteristic for grouping shipments. + + + + + Plant from which the goods should be delivered to the customer. + This plant is automatically copied into the sales order item as the default value.If there is no default value when you process the sales order item, enter a delivering plant.The value proposed in the item is eitherfrom the customer master record of the goods recipient, orfrom the material master recordThe system checks whether it can propose a value (and for your own plants, whether the material has been created in the plant). If the system can propose a value, the plant is copied to the sales order item where you can change it as required. + + + + + A geographical sales district or region. + Each customer can be assigned to a sales district. You can use sales districts to apply pricing conditions. When you want to generate sales statistics, you can use sales districts as a selection criteria.The system can propose a value from the customer master record of the sold-to party. You can change the value manually in the document at the header or item level. + + + + + The account group is a classifying feature within customer master records. The account group determines: + in which number range the customer account number should be;whether the number is assigned by the user or by the system;which specifications are necessary or possible in the master record. + + + + + + + + + + + + + + + + + Gives an alphanumeric key, which clearly identifies the customer or vendor in the SAP system. + + + + + + An organizational unit responsible for the sale of certain products or services. The responsibility of a sales organization may include legal liability for products and customer claims. + You can assign any number of distribution channels and divisions to a sales organization. A particular combination of sales organization, distribution channel, and division is known as a sales area. + + + + + Specifies a distribution channel that you want to use as a reference for customer and material master data for other distribution channels. + You can specify one distribution channel as the source of customer and material master data for other distribution channels. You need then only to maintain the data in one place.Distrib.channel Ref.distrib.channel01 0102 0103 0104 04In this example, only distribution channels 01 and 04 have customer and material master data defined. Distribution channels 01, 02, and 03 share the master data that you defined for distribution channel 01. Distribution channel 04 has its own master data. When you create a sales order in distribution channel 03, the system checks the customer and material master data against the data defined for distribution channel 01. + + + + + A way of grouping materials, products, or services. The system uses divisions to determine the sales areas and the business areas for a material, product, or service. + A product or service is always assigned to just one division. From the point of view of sales and distribution, the use of divisions lets you organize your sales structure around groups of similar products or product lines. This allows the people in a division who process orders and service customers to specialize within a manageable area of expertise.If a sales organization sells food and non-food products through both retail and wholesaledistribution channels each distribution channel could then be further split into food and non-food divisions. + + + + + Identifies the country in which the delivery originates. + You can define the country key in a table. As a rule, it is a good idea to use the existing international standards for identifying vehicles from different countries (for example: USA = United States, I = Italy, and so on). The system uses the key tohelp determine the relevant taxes during pricingdetermine important country-specific standards (the length of postal codes and bank account numbers, for example) + + + + + Identifies the condition that the system uses to automatically determine country-specific taxes during pricing. + You can define one or more tax categories for each country. During sales order processing, the system applies the tax category according tothe geographical location of your delivering plant and the location of the customer receiving the goodstax classifications in the customer master record and the material master record.In the USA, for example, you can define tax categories for Federal Sales Tax and Federal Excise Tax. In the U.K., you can define a tax category for Value Added Tax (VAT). + + + + + Specifies the tax liability of the customer, based on the tax structure of the customer's country. + You can use the tax classification to specify, for example, whether a customer is liable for sales taxes, such as VAT or state sales taxes.During sales order processing, the system copies the tax classification from the tax information stored in thecustomer master record of the payer, if the payer is different from the sold-to party and the sales tax identification number is maintained for the payer.ship to party, if the sales tax identification number of the ship-to party is maintained.sold-to party, if none of the criteria for the payer or the ship-to party are met.During pricing, the system calculates any relevant taxes by taking the following factors into account:The tax classification of the customer and the materialThe country keys of the customer and the delivering plant + + + + + + + + + + + + Gives an alphanumeric key, which clearly identifies the customer or vendor in the SAP system. + + + + + + The company code is an organizational unit within financial accounting. + + + + + + This indicator is used to classify the different types of withholding tax. + Withholding tax types classify particular features of a withholding tax including:The time at which the withholding tax is postedThe basis on which the base amount is calculatedThe basis for accumulation (if applicable)Withholding tax types are to be distinguished from withholding tax codes, to which are allocated the withholding tax percentage rate example.Whether a withholding tax can be defined as an existing type by means of a new code, or if a new type needs to be defined will depend on the type of transaction (see below).Note that a business transaction can only be assigned one withholding tax code per withholding tax type. If the business transaction is subject to several withholding taxes simultaneously, these must be represented by different types.This is the case in Argentina for example, where up to four kinds of withholding tax per business transaction are possible. + + + + + One or more "withholding tax codes" are assigned to each withholding tax type. One of the things these codes determine is the various percentage rates for the withholding tax type. + Note that when processing a business transaction, no more than one withholding tax code can be assigned per withholding tax type. If the business transaction is subject to more than one withholding taxes, these must be represented in the system by defining various withholding tax types. + + + + + + Date from which: + The company code is obligated to withhold tax for the given withholding tax type.This date must be entered in Customizing under the withholding tax information for the company code.The customer is obligated to withhold tax for the withholding tax type.This date must be defined in the customer master record. + + + + + Date to which: + The company code is obligated to withhold tax for the withholding tax type.This date must be entered in Customizing under the withholding tax information for the company code.The customer is obigated to withhold tax for the withholding tax type. + + + + + This is a number issued by the tax authorities per withholding tax type. + This number must be specified in Customizing either:(a) As part of the withholding tax information defined for the company code, or(b) As part of the withholding tax information defined in the customer or vendor master record. + + + + + Numbered assigned by the relevant authorities for exemption from withholding tax. + This number must be entered in the system as follows:In the vendor master record in the case of vendorsFor customers, in Customizing under the settings for withholding tax information for the company code per withholding tax type. + + + + + Rate of exemption from withholding tax. + Those persons/activities subject to withholding tax can be exempted from withholding tax up to the percentage rate you enter here. This exemption rate refers to the withholding tax amount itself and not to the whole amount liable to withholding tax (withholding tax base amount).The gross amount of an invoice is 100.00 and the withholding tax base amount is defined as gross. The withholding tax rate is 10% meaning that the withholding tax amount is 10.00. Given an exemption rate of 30%, the withholding tax amount is reduced to 7.00. + + + + + Date from which withholding tax exemption applies. + + + + + + Date on which withholding tax exemption expires. + + + + + + Indicator used to classify different types of exemption from liability to a particular withholding tax. + These indicators can be defined per withholding tax type in the vendor master record. + + + + + The authorization group allows extended authorization protection for particular objects. The authorization groups are freely definable. The authorization groups usually occur in authorization objects together with an activity. + + + + + + + + + + + + + + + + Gives an alphanumeric key, which clearly identifies the customer or vendor in the SAP system. + + + + + + An organizational unit responsible for the sale of certain products or services. The responsibility of a sales organization may include legal liability for products and customer claims. + You can assign any number of distribution channels and divisions to a sales organization. A particular combination of sales organization, distribution channel, and division is known as a sales area. + + + + + The way in which products or services reach the customer. Typical examples of distribution channels are wholesale, retail, or direct sales. + You can maintain information about customers and materials by sales organization and distribution channel. Within a sales organization you can deliver goods to a given customer through more than one distribution channel.You can assign a distribution channel to one or more sales organizations. If, for example, you have numerous sales organizations, each sales organization may use the "Wholesale" distribution channel.For each combination of sales organization and distribution channel, you can further assign one or more of the divisions that are defined for the sales organization. You can, for example, assign "Food" and "Non-food" divisions to the "Wholesale" distribution channel. A particular combination of sales organization, distribution channel, and division is known as a sales area. + + + + + A way of grouping materials, products, or services. The system uses divisions to determine the sales areas and the business areas for a material, product, or service. + A product or service is always assigned to just one division. From the point of view of sales and distribution, the use of divisions lets you organize your sales structure around groups of similar products or product lines. This allows the people in a division who process orders and service customers to specialize within a manageable area of expertise.If a sales organization sells food and non-food products through both retail and wholesaledistribution channels each distribution channel could then be further split into food and non-food divisions. + + + + + The sequential number that the system applies when there is more than one partner for a particular partner function. + When you create a sales order for a particular customer, there may be more than one ship-to party defined. The different ship-to parties are numbered sequentially. + + + + + The abbreviated form of the name that identifies the partner function. + + + + + + + Sold-to party number sent in by the customer in delivery schedules. + The system uses this number to automatically determine the ship-to party. + + + + + Specifies a partner as the default for a particular partner function. + When you enter more than one partner for a particular partner function (for example, you define three different ship-to parties), you can select one partner as the default. During sales or purchasing processing, if you have defined multiple partners for a partner function, the system prompts you to choose just one partner. The system presents the default partner as the first choice in the pop-up window. + + + + + The authorization group allows extended authorization protection for particular objects. The authorization groups are freely definable. The authorization groups usually occur in authorization objects together with an activity. + + + + + + + + + + + Specifies an alphanumeric key that uniquely identifies the supplier in the SAP system. + + + + + + The account number of the vendor with whom automatic payment transactions are carried out. + The field is only needed if payments are not to be made directly to the vendor to whom the payable is owed. The same applies to bank collections of receivables.The specification in this field applies to all company codes. There is a further field in which every company code can enter an alternative payee separately. If both fields are filled, the company code specification has priority. + + + + + The authorization group allows extended authorization protection for particular objects. The authorization groups are freely definable. The authorization groups usually occur in authorization objects together with an activity. + + + + + + Name with which the user who entered the master record was logged on in the R/3 System. + + + + + + Date on which the master record, or the part of the master record being viewed, was created. + + + + + + Gives an alphanumeric key, which clearly identifies the customer or vendor in the SAP system. + + + + + + + Indicates that the account is blocked for posting for all company codes. + If you set this indicator, the system prevents users from posting items to this account and issues an error message to inform them that the account is blocked. + + + + + Indicates whether or not the supplier master record is blocked for all departments (that is, whether or not posting to this record is allowed at all). + + + + + + The account group is a classifying feature within vendor master records. The account group determines: + the number interval for the account number of the vendor,whether the number is assigned by the user or by the system,which specifications are necessary and/or possible in the master record. + + + + + + + VAT registration number (VAT reg.no.) of the customer, vendor or your company code. + The VAT registration number is used within the EU for tax-exempt deliveries for the "EC sales list". The check rules are defined for each EU country and cannot be changed. + + + + + + + Indicates that all data in this master record is to be deleted. + To delete this data, you have to run the archiving program for Accounts Receivable or Payable. This program will archive all master records marked for deletion provided that there is no dependent data in them.Deletion flags can also be used in the program for deleting master data. You should, however, run this program only to delete test data prior to production startup. + + + + + Specifies an additional master record in which the official address is stored. + This address is used in Italy for business transactions with the tax office in Italy. + + + + + An industry is a distinct group of companies with the same basic business activity. The industry key is used in selecting data for evaluations (for example, a vendor master data list). You can specify industries such as trade, banking, service, manufacturing, health care, public service, media and so on. + The industry field belongs to the general data area of customer and vendor master records. + + + + + Here you enter the first 7 digits of the international location number. + The International Location Number (ILN) is assigned (in Germany by the Centrale for Coorganisation GmbH)) when a company is founded. It consists of 13 digits, the last digit being the check digit. There are two categories of location numbers:Participants who only need an ILN to cleary and unmistakably identify themselves for communication with the business partner are given a category 1 ILN. This cannot be used to identify articles by means of EAN.Participants who wish to assign the location numbers for their own enterprise areas are given a category 2 ILN. For a category 2 ILN, digits 1 to 7 are described as basis number. This is used as basis for the creation of article numbers (EAN). + + + + + Here, you enter digits 8-12 of the 13-digit international location number. + The international location number (ILN) is assigned when establishing a company (by the "Zentrale für Coorganisation GmbH" in Germany). It consists of 13 digits, the last of which is the check digit. There are two types of international location numbers:Subscribers who only need one ILN to identify themselves in communication with the business partner are given an ILN of type 1. These cannot be used for identifying articles by means of EAN.Subscribers who need to assign location numbers for their own company areas are given an ILN of type 2. Positions 1 through 7 of the ILN type 2 are known as the basis number. This basis number forms the basis for article numbers (EAN). + + + + + The check digit is derived from a special check digit procedure from digits of the previous international location numbers. In this way, you can check whether the ILN entered is actually valid. + + + + + + Denotes a natural person. + In the following countries, the system needs to know whether the taxpayer is a legal or natural person so that it can check the tax numbers correctly:BrazilBulgariaColombiaCroatiaGreeceItalyMexicoPeruSloveniaThailandUkraineThe flag is also used in conjunction with the Statement of Payments to Natural Persons report, as used in the Czech Republic and in Slovakia. This report only covers customers and vendors for whom you have set this indicator.In South Korea, it is used in conjunction with the Generic Withholding Tax Reporting program. + + + + + Classification of companies according to tax aspects. + + + + + + Date up to which the certification of the QM-system is valid. + + + + + + If a QM system is maintained by the supplier, you can store a description of the QM system here. + If a material is activated for QM in procurement, the system initiates the following check whenever purchasing functions are carried out (for example, when a request for a quotation is made or if a purchase order is created):Whether the supplier's verified QM system, according to supplier master record or quality info-record (for a combination of supplier/material) meets the requirements for QM systems as specified in the material masterIn carrying out the check, the system relies on the defined assignments for target QM systems and actual QM systems in the Customizing application.If the check is unsuccessful, a warning message is issued when a request for quotation is initiated and an error message is issued for all other procurement activities. + + + + + If the customer or the vendor belongs to a group, you can enter a group key here. The group key is freely assignable. + If you create a matchcode using this group key, group evaluations are possible. + + + + + Key that determines which procurement functions (for example, request for quotation, purchase order, or goods receipt) should be blocked for quality reasons. + You can enter a block key in the:Supplier master recordIn this case, the supplier block applies to all materials and plants.Quality info record for QM in procurementIn this case, the supplier block applies to a single material and plant.A block for quality reasons applies only to those materials for which QM in procurement is active. + + + + + Specifies the tax number. + Enter the appropriate tax number:Country Tax NumberArgentina CUIT number or CUIL numberBelgium Enterprise numberBrazil CNPJ numberBulgaria Unified identification codeChile RUT numberChina VAT registration number (shui wu deng ji hao)Colombia NIT numberCroatia Legal persons: company identification numberNatural persons: JMBG numberCzech Republic DIC numberFrance SIRET numberGreece Personal IDHungary Tax numberItaly Fiscal codeKazakhstan RNN (obsolete)Mexico RFC numberNetherlands SI registration number (Aansluitnummer UWV) of chain- liability vendorNorway VAT numberPeru RUC numberPhilippines Taxpayer identification number (see below)Poland NIP numberPortugal NIF numberRomania Tax numberRussia INNSlovakia DIC numberSlovenia Tax numberSouth Korea Natural persons: Personal identification numberLegal persons: Corporation IDSpain NIF numberSwitzerland UID numberTaiwan GUI registration numberThailand Personal IDTurkey Name of business partner's tax officeUkraine Taxpayer identification numberUnited Kingdom Company registration numberUnited States Social security numberVenezuela RIF numberIn the Philippines, enter the taxpayer identification number with a V or N at the end, as follows:If the business partner is liable to VAT: 999-999-999-999VIf the business partner is not liable to VAT: 999-999-999-999N + + + + + Specifies the tax number. + Enter the appropriate tax number:Country Tax NumberArgentina NIP number or CM numberBelgium VAT numberBrazil CPF numberBulgaria Legal persons: tax numberNatural persons: personal IDCroatia OIB number Czech Republic ICO numberFrance SIREN numberGreece AFM numberIndia TINItaly VAT numberKazakhstan BC (Beneficiary Code)Netherlands BSN numberRussia OKPO codeSlovakia ICO numberSouth Korea VAT registration numberSweden Organization registration numberSwitzerland VAT numberTaiwan Tax registration numberUkraine Legal persons: USREOU numberNatural persons: SRNP numberTurkey Tax numberUnited Kingdom NI numberUnited States Employer identification numberVenezuela NIT number + + + + + Specifies the tax number. + Enter the tax number that applies:Country Tax numberArgentina Withholding agent numberBrazil State tax numberBulgaria Social security numberMexico CURP numberKazakhstan BINNetherlands Tax registration number (Loonbelastingnummer) of the chain-liability vendorRussia KPP numberThailand Tax ID Ukraine VAT registration number + + + + + Specifies the tax number. + Enter the appropriate tax number:Country Tax NumberBrazil Municipal tax numberKazakhstan IINRussia OFK number (for public bodies only) + + + + + Kazakhstan + Specifies the certificate of registration as VAT payer in the following format: XXXXXYYYYYYYZZZZZZZZ, where: XXXXX is the certificate serial number, YYYYYYY is the certificate number and ZZZZZZZZ is the date of certificate issue. + + + + + The tax number of the vendor at the responsible tax authority. + + + + + + Taxes in Argentina: + The format and the check of tax number 1 depend on the two-digit tax number type.The tax number type is an identification type for tax in Argentina (for example, 80 for CUIT) and is used for the DGI tax report. + + + + + + + + + + + + + Specifies an alphanumeric key that uniquely identifies the supplier in the SAP system. + + + + + + The company code is an organizational unit within financial accounting. + + + + + + The authorization group allows extended authorization protection for particular objects. The authorization groups are freely definable. The authorization groups usually occur in authorization objects together with an activity. + + + + + + + Block key (enqueue key) that is used to block an open item or an account to payment transactions. + You can use the block key as described below.Automatic Payment TransactionsIn automatic payment transactions, the block takes effect when it is entered in the system as follows:In the master recordIn the documentIf you enter the block in the master record then all open items for this account are contained in the exception list.The following block keys have a special meaning in the master record:The block key * has the effect that all items of the account are skipped in automatic payment transactions.The block key + has the effect that all items are skipped in which a payment method was not entered explicitly.The block key A is always set automatically when a down payment is entered. Therefore, you must not delete the block key A or use it for other purposes.Whether a block key can be set or removed in payment proposal processing depends on the attribute Changeable in payment proposal of the block key.Manual PaymentsManual payments are only affected by a block key in the document if you set the attribute Blocked for manual payments in the block key.A block key that was set in the master record does not have any effect on manual payments. You can have the system issue a warning message in that case. To do so, you have to make system settings. Set up message 671 of work area F5 in message control accordingly. + + + + + Indicates that the account is blocked for posting in the specified company code. + If you set this indicator, the system prevents users from posting items to this account and issues an error message to inform them that the account is blocked. + + + + + Identification code for the accounting clerk. + The name of the accounting clerk defined by this identification code can be used in the payment program for correspondence and reporting (for example, open item lists). + + + + + + + Name or identification code of the accounting clerk at the vendor. + + + + + + + List of payment methods which may be used in automatic payment transactions with this customer/vendor if you do not specify a payment method in the item to be paid. + If you do specify a particular payment method in the item to be paid, this specification has priority over the specifications in the master record. You may also specify payment methods in the item which are not listed in the master record. + + + + + Key for defining payment terms composed of cash discount percentages and payment periods. + It is used in sales orders, purchase orders, and invoices. Terms of payment provide information for:Cash managementDunning proceduresPayment transactionsData can be entered in the field for the terms of payment key in various ways as you enter a business transaction:In most business transactions, the system defaults the key specified in the master record of the customer/vendor in question.In some transactions (for example, credit memos), however, the system does not default the key from the master record. Despite this, you can use the key from the customer/vendor master record by entering "*" in the field.Regardless of whether or not a key is defaulted from the master record, you can manually enter a key during document entry at:item level in sales ordersheader level in purchase orders and invoicesMaster records have separate areas for Financial Accounting, Sales, and Purchasing. You can specify different terms of payment keys in each of these areas. When you then enter a business transaction, the application in question will use the key specified in its area of the master record. + + + + + Indicates that during automatic payment transactions, clearing is made with the corresponding customer account, and that during manual clearing procedures, the items of that customer account are also selected. + To use this function in automatic payment transactions, you have toenter the customer account number in the vendor master record,enter the vendor account number in the customer master record, andselect the "Clearing with vendor" indicator in the customer master record.If this indicator is set, items belonging to the customer account will be included in any dunning run. + + + + + Indicates that payment transactions and dunning notices are created for the branch. + Normally automatic payment transactions and dunning notices are created for the head office.NoteSelect this indicator only if this account is a head office account. + + + + + If this indicator is set, every customer/vendor open item is paid separately during automatic payment transactions. This means that open items are not grouped together for payment. + + + + + + This indicator specifies that the customer/vendor should be sent all payment advice information by EDI. + + + + + + All bank data is determined using this key. + + + + + + Number of days which usually pass until the vendor has cashed your check. + During automatic payment transactions, the system calculates the value date for check payments using this information and stores the date in the line item. The date is calculated as follows:Value date = posting date + check cashing timeIn Cash Management, the value date is used as information about the expected cash outflow. + + + + + Maximum amount which may be issued on a bill of exchange if it is to be used in payment transactions with the business partner. + The amount limit is taken into consideration in automatic payment transactions for payments by bill of exchange and bill of exchange payment requests. Several bill of exchange forms are created if the amount to be settled is higher than the maximum amount given here. Each of these bills of exchange is issued for the maximum amount or for a smaller amount.Amount limits for bills of exchange are used in Spain, for example. + + + + + This field contains the account number the company is listed under at the vendor. + + + + + + The reconciliation account in G/L accounting is the account which is updated parallel to the subledger account for normal postings (for example, invoice or payment). + For special postings (for example, down payment or bill of exchange), this account is replaced by another account (for example, 'down payments received' instead of 'receivables').The replacement takes place due to the special G/L indicator which you must specify for these types of postings. + + + + + Enter an interest calculation indicator here if the account is to be included in automatic interest calculation. + + + + + + The date in this field displays the last time the interest calculation program processed this account. This is generally the upper limit of the last interest run. + Generally, this date is automatically maintained by the program (batch input). A manual entry in this field should only be made if an error has occurred or when implementing the interest calculation. + + + + + An entry in this field determines the intervals (in months) at which interest is to be calculated automatically for this account (account balance interest calculation). The interest calculation frequency is added to the date of the last interest calculation. + Date of last interest calculation: 3/31.+ 01 month interest calculation frequency= 4/30 upper limit for the current interest runThe calculation period specified as a report parameter determines whether an account is included in an interest run.The upper limit of the interest run is calculated as in the above example and compared with the upper limit of the calculation entered in the interest run (report parameter). If the calculated upper limit is after the calculation period, the account is not included in interest calculation.If you maintain the interest calculation frequency in the account master record, this entry is used to calculate the upper limit. If not, the interest calculation frequency entered for the interest indicator is used. + + + + + This field contains the account number of the master record for the head office account. + You specify this account number only for branch accounts. Items that you post using the branch account number are automatically posted to the head office account. The system records the branch account number in the line items.Neither transactions nor balances are kept in the branch account. + + + + + The account number of the vendor with whom automatic payment transactions are to be carried out. + The field is only needed if payments are not to be made directly to the vendor to whom the payable is owed. The same applies to bank collections of receivables.The specification in this field applies only to the company code. There is a further field in which you can enter an alternative payee for each company code. If both fields are filled, the company code specified has priority. + + + + + Indicates the layout rule for the Allocation field in the document line item. + The system uses a standard sort sequence for displaying line items. Among other things, it sorts the items according to the content of the Allocation field. This field can be filled either manually or automatically (by the system) when a document line item is entered.For this purpose, the system requires rules that determine which information is to be taken from the document header or from the document line item and placed in the field. The rules can be stored in the master record of an account which enables you to determine the standard sort sequence on an account-specific basis.NoteField information from another document line item cannot be adopted into the field of a particular item. + + + + + Contains settings that control how the system handles differences between the invoice amount and the amount received from a customer or the amount paid to a supplier. A tolerance group is unique within a company code. + + + + + + US government requirement. + Date field in which to enter certification date for small companies run by women or minorities. This certificate must be renewed every two years. + + + + + Internal memo of the accounting department. + The memo serves only as information on special features of the customer/vendor. + + + + + In some countries, an additional country is needed for calculating or reporting withholding tax. + The calculation can depend on the payee's country.A particular country key can be required by law for reporting which may possibly be different to the key used in the address.Examples: Japan, USA (1042), Argentina + + + + + Indicates that the company code data in this master record is to be deleted. + To delete this data, you have to run the archiving program for Accounts Receivable or Payable. This program will archive all master records marked for deletion provided that there is no dependent data in them.This deletion flag cannot be used in the program that deletes master data. You should, however, run this program only to delete test data prior to production startup. + + + + + In cash management, customers and vendors are allocated to planning groups by means of an entry made in the master record. + You can define these planning groups in Customizing or the Implementation Guide (you will need to ensure that they are all the same length). In order to improve the liquidity forecast display for major customers and vendors, it can be advisable to enter their account number as the planning group.For the planning groups themselves a naming convention should be set up to improve liquidity forecasting. In the following examples, the customer planning groups begin with an "R" for receipts, and the vendor planning groups begin with an "E" for expenses.R1 Customers paying by bank collectionR2 Other domestic customersR3 Customers abroadR4 Affiliated company customersR5 High risk customersR6 Major customersR7 Rental incomeR8 Repayment of loans...E1 Domestic vendorsE2 Vendors abroadE3 Affiliated company vendorsE4 Major vendorsE5 Personnel costsE6 TaxesE7 Investments... + + + + + When incoming invoices are entered or when memos are entered in Financial Accounting (FI), the system checks whether an invoice or credit memo has already been entered for the same date. + Checking Logistics DocumentsThe system checks whether the invoice documents have already been entered in the Logistics invoice verification. For this, the system checks invoices that have been held or parked or that contain errors, or invoices that were entered for invoice verification in the background. The check is performed only if you specify the reference document number when you enter the invoices.When checking for duplicate invoices, the system compares the following specified characteristics:VendorCurrencyCompany CodeGross Invoice AmountReference Document NumberInvoice Document DateIf all of these characteristics are the same, the system issues a message for which you can change the message type in Customizing.When you enter credit memos or subsequent adjustments, the system does not check for duplicate invoices.Exception: The exception is the Argentina country version, where the system checks for duplicate invoices and credit memos.No message is issued if you enter a document that has previously been reversed.In Customizing for Logistics Invoice Verification under Incoming Invoice -> Set Check for Duplicate Invoices, you can specify that the following characteristics are not checked:Reference Document NumberInvoice Document DateCompany CodeHaving fewer attributes to check increases the likelihood that the system will find a duplicate invoice.Example:The following document has already been entered and posted:Reference Document Number 333Invoice Date: 4/28/2000Gross Invoice Amount 100.00Currency: EURVendor: SpencerCompany Code: ChicagoYou have set up the check for duplicate invoices as follows in Customizing:The characteristics Reference Document Number and Company Code are not activated. Consequently, these characteristics are not checked.Now you enter the following invoice:Reference Document Number 334Invoice Date: 4/28/2000Gross Invoice Amount 100.00Currency: EURVendor: SpencerCompany Code: FlagstaffResultBecause you entered a reference document when you entered the invoice, the system checks for duplicate invoices. Compared against the invoice entered earlier, the invoice just entered has different values in the characteristics Reference and Company Code. However, these characteristics are not checked due to the settings that you have made in Customizing. All other characteristics are the same. The system issues a message telling you that an invoice has been entered twice.If the characteristic "Reference Document Number" had been selected in Customizing, the system would have checked the reference document number and established that it was different from the invoice entered earlier, and it consequently would not have issued a message.Checking FI DocumentsThe system checks whether there are FI documents that were posted or parked with the Logistics invoice verification or with an FI invoice transaction. Depending on the entry in the Reference field, one of the following checks is performed:If a reference number was specified in the sequential invoice/credit memo, the system checks whether an invoice/credit memo has already been posted for which all the following attributes agree:Company CodeVendorCurrencyDocument DateReference NumberIf no reference number was specified in the sequential invoice/credit memo, the system checks whether an invoice/credit memo has already been posted for which all the following attributes agree:Company CodeVendorCurrencyDocument DateAmount in Document CurrencyIn Materials Management, the system applies the check for duplicate invoices for invoices only, not for credit memos. + + + + + The account group is a classifying feature within vendor master records. The account group determines: + the number interval for the account number of the vendor,whether the number is assigned by the user or by the system,which specifications are necessary and/or possible in the master record. + + + + + + + + + + + + + + Specifies an alphanumeric key that uniquely identifies the supplier in the SAP system. + + + + + + The company code is an organizational unit within financial accounting. + + + + + + The dunning area represents an organizational entity that is responsible for dunning. The dunning areas represent a sub-structure of the company codes. + If different responsibilities or different dunning procedures exist within a company code, you can set up corresponding dunning areas.All dunning notices are made separately according to dunning areas, and if necessary with different dunning procedures.The dunning area must be noted in the line items. As long as documents are copied from preliminary work areas (billing documents), the dunning area can be derived from details such as division or sales area, if necessary. + + + + + Key which reflects the reason for a dunning block indicator. + + + + + + Number that specifies how often an item or account has been dunned. + The business partner has received the dunning level from the last dunning run.If you use dunning areas, it is the dunning level that the business partner received from the last dunning run in the dunning area assigned.The dunning program sets the dunning level automatically when the customer or vendor receives a dunning notice. + + + + + This field contains the key for the dunning procedure to be used. + + + + + + Account number of the vendor who is to receive the dunning notice. + Note:If an entry is not made in this field, the dunning notice is sent to the address of the vendor to be processed. + + + + + Date on which the last dunning notice was made. + + + + + + Date on which a legal dunning procedure was initiated. + The printing of dunning notices in the legal dunning procedure generates an internal notice about any further account movements. A dunning notice is not created for the customer.If the Legal dunning procedure field in the master record contains a date, this means that the account is involved in a legal dunning procedure. The relationship between this date and the dunning date does not affect how the account is processed.The printing of account movements in the legal dunning procedure differs from the normal printing of dunning notices as follows:You must specify a separate form for your dunning procedure in Customizing. For more information, see Customizing (IMG) under Dunning Forms.The dunning program also displays text element 520 "Legal dunning procedure". This makes it possible to display the date of the legal dunning procedure from the master record.The program also displays the documents blocked for dunning and those with a payment method (automatic debit, bank direct debit).Although dunning notices are printed, the dunning level does not change in the master record or in the items. New dunning level = old dunning level.The program only updates the date of the last dunning run.Enter the date manually. + + + + + Identification code for the accounting clerk dealing with dunning letters. + Using this identification code, the accounting clerk whose name is printed on the dunning letters is determined.If this field is not filled, then the entry from the Accounting clerk field is used. + + + + + The authorization group allows extended authorization protection for particular objects. The authorization groups are freely definable. The authorization groups usually occur in authorization objects together with an activity. + + + + + + The account group is a classifying feature within vendor master records. The account group determines: + the number interval for the account number of the vendor,whether the number is assigned by the user or by the system,which specifications are necessary and/or possible in the master record. + + + + + + + + + + + + + + + Specifies an alphanumeric key that uniquely identifies the supplier in the SAP system. + + + + + + Denotes the purchasing organization. + + + + + + Subdivision of a supplier's overall product range according to various criteria. + For each supplier sub-range:The master data is kept on a common basisCertain conditions applyIn the supplier master, you can create different purchasing data and different partner functions for each supplier sub-range.You can also maintain and change the conditions for each supplier sub-range. You assign a material to a supplier sub-range in the info record.In the supplier master, you can maintain different data for particular supplier sub-ranges, such as ordering addresses or terms of payment, for example.When creating a purchase order with a known supplier, different data is only determined if the supplier sub-range is entered in the initial screen.Your supplier Smith in Houston has two sub-ranges: paint and glue.All materials from the "paint" sub-range are ordered in Houston.You have maintained an alternative ordering address in Detroit for the "glue" sub-range.If you order materials from the "glue" sub-range, the supplier sub-range finds the Detroit ordering address. + + + + + Key uniquely identifying a plant. + + + + + + The abbreviated form of the name that identifies the partner function. + + + + + + The sequential number that the system applies when there is more than one partner for a particular partner function. + When you create a sales order for a particular customer, there may be more than one ship-to party defined. The different ship-to parties are numbered sequentially. + + + + + Specifies a partner as the default for a particular partner function. + When you enter more than one partner for a particular partner function (for example, you define three different ship-to parties), you can select one partner as the default. During sales or purchasing processing, if you have defined multiple partners for a partner function, the system prompts you to choose just one partner. The system presents the default partner as the first choice in the pop-up window. + + + + + + + + The authorization group allows extended authorization protection for particular objects. The authorization groups are freely definable. The authorization groups usually occur in authorization objects together with an activity. + + + + + + + + + + + + Alphanumeric key uniquely identifying the document. + With the supplier number, information from the supplier master record (such as the supplier's address and bank details) is copied into a purchasing document (such as a request for quotation or a purchase order).You can use the supplier number to keep track of requests for quotation, purchase orders and outline agreements. + + + + + Denotes the purchasing organization. + + + + + + Determines which calculation schema (pricing procedure) is to be used in purchasing documents containing this supplier number. + You can use the schema group to specify the calculation schema per purchasing organization or supplier. The relevant calculation schema is determined by reference to the schema group.The effect of this is that the conditions to be maintained in a purchasing document can differ depending on the relevant purchasing organization or supplier.If a calculation schema is only to be valid for certain purchasing organizations or suppliers, proceed as follows:Define the schema group for the purchasing organization or the supplier using the relevant function in the menu "Calculation schema -> Schema groups".Assign the schema group to the calculation schema via "Calculation schema -> Determine schema".Enter the schema group for the supplier in the supplier master records to which the calculation schema is to be assigned. Assign the schema group of the purchasing organization to the relevant purchasing organization using "Calculation schema -> Schema group -> Assign to purch. org.". + + + + + Indicates whether or not the supplier master record is earmarked for deletion. + + + + + + Commonly used trading terms that comply with the standards established by the International Chamber of Commerce (ICC). + Incoterms specify internationally recognized procedures that the shipper and the receiving party must follow for the shipping transaction to be completed successfully.If goods are shipped through a port of departure, the appropriate Incoterm might be: FOB ("Free On Board"). You can provide further details (for example, the name of the port) in the secondary Incoterm field: FOB Boston, for example. + + + + + Additional information for the primary Incoterm. + If the primary Incoterm is, for example, FOB ("Free on Board"), then the second field provides details of the port from which the delivery leaves (for example, "FOB Boston"). + + + + + An incoterms version is an edition containing a list of international terms for transportation that is defined by the International Chamber of Commerce (ICC). + + + + + + Provides additional information for the primary Incoterm. For Incoterms 2010, this field represents: + 1. For sea and inland waterway transport - Port of Shipment2. For any mode of transport - Place of Delivery 2010Incoterms are divided as follows:Group 1: Rules for any mode or modes of transport (including by vessel)Incoterms Incoterms Description Location 1 EXW Ex Works Place of DeliveryFCA Free Carrier Place of DeliveryCPT Carriage Paid To Place of DestinationCIP Carriage & Insurance Paid To Place of DestinationDAF Delivered at Frontier Place of DeliveryDDP Delivered Duty Paid Place of DestinationDDU Delivered Duty Unpaid Place of DestinationGroup 2: Rules for sea and inland waterwaysIncoterms Incoterms Description Location 1 FAS Free Alongside Ship Port of ShipmentFOB Free On Board Port of ShipmentCFR Cost & Freight Port of DestinationCIF Cost Insurance & Freight Port of DestinationDEQ Delivered Eq Quay (Duty Paid) Port of DestinationDES Delivered Ex Ship Port of DestinationIf the primary incoterm is specified as FOB “Free on Board”, the second field provides details of the port from which the delivery leaves, such as FOB Boston. + + + + + Provides additional information for the Incoterms. This field is only available for C-Clauses (if customized appropriately). Note the following for the incoterms versions below: + No Version:This field is disabledIncoterm Version 2000This field is disabled as part of standard delivery unless a customer decides to enable it by the way of Customizing for Sales and Distribution under Master Data -> Business Partners -> Customers -> Billing Document -> Incoterms -> Map Incoterms to Versions.Incoterm Version 2010For this version, the field represents:Sea and inland waterway transport - Port of DestinationAny mode of transport - Place of Destination2010 Incoterms are divided as follows:Group 1: Rules for any mode or modes of transport (including by vessel)Incoterms Incoterms Description Location 2CPT Carriage Paid To Place of DestinationCIP Carriage & Insurance Paid To Place of DestinationGroup 2: Rules for sea and inland waterwaysIncoterms Incoterms Description Location 2CFR Cost & Freight Port of DestinationCIF Cost Insurance & Freight Port of Destination + + + + + Indicator specifying that provision has been made for goods-receipt-based invoice verification for a purchase order item or invoice item. + + + + + + Number of calendar days needed to obtain the material or service if it is procured externally. + If you have different vendors for a material, you must specify an average value. The same applies if you order the material from a fixed vendor that has varying delivery times.If you use the SAP Retail System, the planned delivery time can be suggested from the vendor sub-range in the vendor master record. + + + + + Minimum value specified for purchase orders issued to the relevant supplier. + + + + + + Key for defining payment terms composed of cash discount percentages and payment periods. + It is used in sales orders, purchase orders, and invoices. Terms of payment provide information for:Cash managementDunning proceduresPayment transactionsData can be entered in the field for the terms of payment key in various ways as you enter a business transaction:In most business transactions, the system defaults the key specified in the master record of the customer/vendor in question.In some transactions (for example, credit memos), however, the system does not default the key from the master record. Despite this, you can use the key from the customer/vendor master record by entering "*" in the field.Regardless of whether or not a key is defaulted from the master record, you can manually enter a key during document entry at:item level in sales ordersheader level in purchase orders and invoicesMaster records have separate areas for Financial Accounting, Sales, and Purchasing. You can specify different terms of payment keys in each of these areas. When you then enter a business transaction, the application in question will use the key specified in its area of the master record. + + + + + Determines which date is to be used for price determination (pricing) purposes. + Enter the key for the desired date.If you choose the date of goods receipt, for example, a new price will be determined upon the arrival of the goods, causing the item to be revaluated at this time.NoteIf you have chosen the delivery date as the date for price determination and an item contains several delivery dates (i.e. has a delivery schedule), the first delivery date (the delivery date specified in the first schedule line) is taken. + + + + + Allows you to automatically generate purchase orders from purchase requisitions if the requisition has been assigned to a supplier (source of supply). + If you want to use automatic conversion, note the following additional conditions:In the case of purchase requisitions for materials, you should also select the indicator Autom.purch.ord. in the Purchasing view in the material master record.In the case of purchase requisitions for services, you should also select the indicator Automatic creation of POs for service PReqs in Customizing for Services by choosing:IMG -> MM -> External Services Management -> Source Determination and Default Values- for Client or- for Purchasing Organization + + + + + Key for the currency on which an order placed with a supplier is based. + + + + + + Key for a buyer or a group of buyers, who is/are responsible for certain purchasing activities. + Internally, the purchasing group is responsible for the procurement of a material or a class of materials.Externally, it is the medium through which contacts with the vendor are maintained. + + + + + Indicates whether or not the supplier master record is blocked for the purchasing organization for posting purposes. + + + + + + General shipping strategy for the delivery of goods from the vendor to the customer. + You can define shipping conditions in your system which correspond to the requirements of your company. You can specify a shipping condition in the customer master and in the vendor master.Shipping point determination (outbound delivery):The loading group, the plant and the shipping condition determine the shipping point that will be proposed by the system.Route determination (outbound delivery):Apart from the country and the geographical region of the shipping point, the ship-to party and the transportation group, the shipping condition determines the route that the system proposes in the order for the delivery of the goods. In the delivery, the route proposal also takes the weight group into account.A particular customer always requires immediate delivery. You enter the appropriate shipping condition into the customer master record. This means that when you process orders for this customer, the system automatically proposes the express mail room as a shipping point and the quickest way to the airport as a route.If a shipping condition has been assigned to a sales document type in Customizing, this condition will be proposed by the system in the corresponding sales document. If there is no assignment, the system copies the relevant data from the corresponding customer master record of the sold-to party. You cannot change this value during delivery processing. The shipping condition will not be copied from the delivery into the shipment. The shipping condition is one of several criteria for selecting deliveries when you create a shipment. You can enter a shipping condition manually in the shipment where it only serves as a characteristic for grouping shipments. + + + + + Means of classifying suppliers according to their significance to your company. + The indicator serves to assign the supplier to one of the categories A, B or C, in accordance with ABC analysis.'A' category suppliers, for instance, are those accounting for the greatest share of the company's total annual spend (in value terms). + + + + + This telephone number is maintained in the supplier master record and adopted in the purchasing document. + + + + + + + The authorization group allows extended authorization protection for particular objects. The authorization groups are freely definable. The authorization groups usually occur in authorization objects together with an activity. + + + + + + The account group is a classifying feature within vendor master records. The account group determines: + the number interval for the account number of the vendor,whether the number is assigned by the user or by the system,which specifications are necessary and/or possible in the master record. + + + + + + + + + + + + + Specifies an alphanumeric key that uniquely identifies the supplier in the SAP system. + + + + + + The company code is an organizational unit within financial accounting. + + + + + + This indicator is used to classify the different types of withholding tax. + Withholding tax types classify particular features of a withholding tax including:The time at which the withholding tax is postedThe basis on which the base amount is calculatedThe basis for accumulation (if applicable)Withholding tax types are to be distinguished from withholding tax codes, to which are allocated the withholding tax percentage rate example.Whether a withholding tax can be defined as an existing type by means of a new code, or if a new type needs to be defined will depend on the type of transaction (see below).Note that a business transaction can only be assigned one withholding tax code per withholding tax type. If the business transaction is subject to several withholding taxes simultaneously, these must be represented by different types.This is the case in Argentina for example, where up to four kinds of withholding tax per business transaction are possible. + + + + + Date from which withholding tax exemption applies. + + + + + + Date on which withholding tax exemption expires. + + + + + + Indicator used to classify different types of exemption from liability to a particular withholding tax. + These indicators can be defined per withholding tax type in the vendor master record. + + + + + + The type of recipient can be defined in the vendor master record. + It is used to group vendors together according to particular characteristics such as occupations that may be subject to the same withholding tax type, but which are required to pay different percentage rates (as defined by the withholding tax code).Application in ThailandThis corresponds to the official Thai form number (Phaw.Ngor.Daw) and is used to determine the sequential numbering of a withholding tax certificate. The form number is defined in the vendor master record. + + + + + Numbered assigned by the relevant authorities for exemption from withholding tax. + This number must be entered in the system as follows:In the vendor master record in the case of vendorsFor customers, in Customizing under the settings for withholding tax information for the company code per withholding tax type. + + + + + One or more "withholding tax codes" are assigned to each withholding tax type. One of the things these codes determine is the various percentage rates for the withholding tax type. + Note that when processing a business transaction, no more than one withholding tax code can be assigned per withholding tax type. If the business transaction is subject to more than one withholding taxes, these must be represented in the system by defining various withholding tax types. + + + + + Rate of exemption from withholding tax. + Those persons/activities subject to withholding tax can be exempted from withholding tax up to the percentage rate you enter here. This exemption rate refers to the withholding tax amount itself and not to the whole amount liable to withholding tax (withholding tax base amount).The gross amount of an invoice is 100.00 and the withholding tax base amount is defined as gross. The withholding tax rate is 10% meaning that the withholding tax amount is 10.00. Given an exemption rate of 30%, the withholding tax amount is reduced to 7.00. + + + + + This is a number issued by the tax authorities per withholding tax type. + This number must be specified in Customizing either:(a) As part of the withholding tax information defined for the company code, or(b) As part of the withholding tax information defined in the customer or vendor master record. + + + + + The authorization group allows extended authorization protection for particular objects. The authorization groups are freely definable. The authorization groups usually occur in authorization objects together with an activity. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + aggregate + groupby + filter + + + + + + + + + + + diff --git a/suppliers/srv/external/API_BUSINESS_PARTNER.js b/suppliers/srv/external/API_BUSINESS_PARTNER.js new file mode 100644 index 00000000..0121884d --- /dev/null +++ b/suppliers/srv/external/API_BUSINESS_PARTNER.js @@ -0,0 +1,10 @@ +const cds = require('@sap/cds'); + +module.exports = cds.service.impl(function () { + const { A_BusinessPartner } = this.entities; + + // https://api.sap.com/event/SAPS4HANACloudBusinessEvents_BusinessPartner/resource + this.after('UPDATE', A_BusinessPartner, async data => { + await this.emit("BusinessPartner.Changed", { BusinessPartner: data.BusinessPartner }); + }); +}); diff --git a/suppliers/srv/external/data/API_BUSINESS_PARTNER-A_BusinessPartner.csv b/suppliers/srv/external/data/API_BUSINESS_PARTNER-A_BusinessPartner.csv new file mode 100644 index 00000000..a3ae063b --- /dev/null +++ b/suppliers/srv/external/data/API_BUSINESS_PARTNER-A_BusinessPartner.csv @@ -0,0 +1,7 @@ +BusinessPartner;BusinessPartnerFullName +ACME;A Company Making Everything +B4U;Books for You +S&C;Shakespeare & Co. +WSL;Waterstones +TLD;Thalia +PNG;Penguin Books diff --git a/suppliers/srv/mashup.cds b/suppliers/srv/mashup.cds new file mode 100644 index 00000000..16ca03d1 --- /dev/null +++ b/suppliers/srv/mashup.cds @@ -0,0 +1,72 @@ +using { API_BUSINESS_PARTNER as S4 } from './external/API_BUSINESS_PARTNER.csn'; +using { CatalogService, sap.capire.bookshop.Books } from '@capire/bookshop'; +namespace sap.capire.bookshop; + + +/** + Add projections to external entities to capture the subset of fields we're + actually interested in. This fosters both: (a) minimized network traffic as + well as (b) options to dynamically add extension fields by SaaS tenants. + */ +entity Suppliers as projection on S4.A_BusinessPartner { + key BusinessPartner as ID, + BusinessPartnerFullName as name, + // to_BusinessPartnerAddress[1: ValidityStartDate <= $now and $now < ValidityEndDate].CityName, + // to_BusinessPartnerAddress[1: ValidityStartDate <= $now and $now < ValidityEndDate].Country, +} + + +/** + We can mashup entities from external services, or projections thereof, with + our project's own entities, e.g. by adding relationships as below. + */ +extend Books with { + supplier : Association to Suppliers; +} + + +/* + Optionally expose external entities through own services, e.g. for Value Helps, + or to display details fetched on demand. + For this to work, we need to delegate the respective calls addressed to our + services into calls to the external service. + */ +extend service AdminService with { + @cds.odata.valuelist + entity Suppliers as projection on bookshop.Suppliers; +} + + +/* + Optionally add local persistency to replicate data for fast access, + e.g. to display lists containing remote data. + */ +annotate Suppliers with @cds.persistence: {table,skip:false}; + + +/** + Having locally cached replicas also allows to display supplier data in lists + of books, which otherwise would generate unwanted traffic on S4 backends. + */ +extend projection CatalogService.ListOfBooks with { + supplier.name as supplier +} + + +/** + Optionally declare events emitted from the source, but not included in + imported APIs (e.g. as in case of EDMXes from API Hub). + + This allows CAP's advanced support for events and messaging to kick in, + e.g. to automatically emit to and subscribe to events from message brokers + behind the scenes. + + Note: as sync and async APIs from S/4 sources are not correlated, we have + to specify the event type names, e.g. as be found at: + https://api.sap.com/event/SAPS4HANACloudBusinessEvents_BusinessPartner/resource + */ +extend service S4 { + event BusinessPartner.Changed @(type: 'sap.s4.beh.businesspartner.v1.BusinessPartner.Changed.v1') { + BusinessPartner: S4.A_BusinessPartner:BusinessPartner; + } +} diff --git a/suppliers/srv/mashup.js b/suppliers/srv/mashup.js new file mode 100644 index 00000000..300a705d --- /dev/null +++ b/suppliers/srv/mashup.js @@ -0,0 +1,50 @@ +//////////////////////////////////////////////////////////////////////////// +// +// Mashing up provided and required services... +// +module.exports = async()=>{ // called by server.js + + if (!cds.services.AdminService) return //> mocking S4 service only + + // Connect to services we want to mashup below... + const S4bupa = await cds.connect.to('API_BUSINESS_PARTNER') //> external S4 service + const admin = await cds.connect.to('AdminService') //> local domain service + const db = await cds.connect.to('db') //> our primary database + + // Reflect CDS definition of the Suppliers entity + const { Suppliers } = db.entities + + admin.prepend (()=>{ //> to ensure our .on handlers below go before the default ones + + // Delegate Value Help reads for Suppliers to S4 backend + admin.on ('READ', 'Suppliers', req => { + console.log ('>> delegating to S4 service...') + return S4bupa.run(req.query) + }) + + // Replicate Supplier data when edited Books have suppliers + admin.after (['CREATE','UPDATE'], 'Books', async data => { + const { supplier_ID: ID } = data + if (ID) { + let replicated = await db.exists (Suppliers,ID) + if (!replicated) { // initially replicate Supplier info + let supplier = await S4bupa.read (Suppliers,ID) + await INSERT(supplier) .into (Suppliers) + } + } + }) + + }) + + // Subscribe to changes in the S4 origin of Suppliers data + S4bupa.on ('BusinessPartner.Changed', async msg => { //> would be great if we had batch events from S/4 + console.log(">>", msg.event, msg.data) + const ID = msg.data.BusinessPartner; + let replicated = await db.exists (Suppliers,ID) + if (replicated) { // update replicated Supplier info + let supplier = await S4bupa.read (Suppliers,ID) + await UPDATE(Suppliers,ID) .with (supplier) + } + }) + +} diff --git a/test/cds.events.test.js b/test/cds.events.test.js new file mode 100644 index 00000000..1ebe576c --- /dev/null +++ b/test/cds.events.test.js @@ -0,0 +1,22 @@ +const cds = require ('@sap/cds/lib') +const { expect } = cds.test.in (__dirname) + +describe('cds.events tests', ()=>{ + + let m; before (async ()=> m = await cds.load('events.cds')) + + it ('should have the model loaded', ()=>{ + expect(m.definitions).to.have.property('Sue.Foo') + }) + + it ('should compile the model to edmx', ()=>{ + const edmx = cds.compile(m).to.edmx({service:'Sue'}) + expect(edmx).to.match(//) + }) + + it ('should compile the model to sql', ()=>{ + const sql = cds.compile(m).to.sql().join(';\n') + expect(sql).not.to.match(/CREATE TABLE Sue_Foo/) + expect(sql).to.match(/CREATE TABLE Sue_Bar/) + }) +}) diff --git a/test/events.cds b/test/events.cds new file mode 100644 index 00000000..2eae34aa --- /dev/null +++ b/test/events.cds @@ -0,0 +1,6 @@ +service Sue { + @cds.persistence.skip + entity Foo { key ID:Integer; title:String; status:String(1); } + entity Bar { key ID:Integer; foo: Association to Foo } + event Foo.changed : projection on Foo { ID, status } +}