Functionality
Transfer settlement quantities for home delivery settlement from anexternal system into the SAP system
You can use this BAPI to import settlement quantities into the SAPsystem from an external tool for use in home delivery settlement.
Meaning of parameters:
SHIPPING_DATEIN,,,,,,: Shipping date
CARRIER_ROUTEIN,,,,: Carrier route
DELIVERY_ROUNDIN,,,,: Delivery round
DELIVERY_TYPEIN,,,,: Delivery type
MATERIALIN,,,,,,: Material number
SALES_ORGANIZATIONIN,,: Sales organization
DISTRIBUTION_CHANNELIN,,: Distribution channel
DIVISIONIN,,,,,,,,: Division
CARRIER_QUANTITIES,,,,: Settlement quantities
CARRIER_QUANTITIESX,,,,: Settlement quantities - checkboxes
If any errors occur, they are reported in the parameter RETURN.

Notes
The BAPI does not execute a database Commit. This means the callingapplication must execute the Commit so that changes are made on thedatabase. This can be done using the BAPI BAPI_TRANSACTION_COMMIT.

Description
Number of settlement record assigned by the BAPI for the settlementdate, carrier route, delivery round, delivery type, and material.

Description
This structure contains the quantity fields for the settlement record:

• Quantity of the material in question delivered by a carrier in the
specified home delivery round (carrier route/delivery round)

• Quantity of the material in question delivered by a service company in
the specified home delivery round (carrier route/delivery round)

• Unit of measure of the home delivery quantity


• ISO code for unit of measure

Description
You can use this parameter to specify which fields in the parameterCARRIER_QUANTITIES are relevant for change.
The parameter serves the following two purposes:


• Allows you to control processing using the field UPDATEFLAG (change
indicator).
You can make the following entries in this field:
' ' : Create a new settlement record
I: Create a new settlement record
U: Change an existing settlement record. If settlement has alreadytaken place for the record, the function module cancels this process anddisplays an error message.
D: Delete an existing settlement record. If settlement has alreadytaken place for the record, the function module cancels this process anddisplays an error message.

• Allows you to control data entry in fields using checkboxes:

If the field UPDATEFLAG contains an entry, the system only copies thedata from the fields in the parameter CARRIER_QUANTITIES if they aremarked with an 'X'.

Description
Carrier route in which home delivery takes place

Description
Delivery round for carrier route in which home delivery takes place

Description
Delivery type used for home delivery of the material

Description
Distribution channel

Description
Division for material

Description
Number of external settlement record for home delivery settlement.
This parameter identifies a settlement record in a change/deletionfunction (field CARRIER_QUANTITIESX-UPDATEFLAG contains a U or a D). Ifthis is not the case, the function module cancels processing anddisplays an error message.
This parameter is not used in conjunction with creation functions.

Description
Material number of material distributed by home delivery

Description
Sales organization

Description
Date on which shipping (home delivery) takes place for the material.

Description
This parameter is used as a test switch.
If the switch is selected, the settlement record is not saved.

Value range
Space = Settlement record is to be saved
X = Settlement record is not to be saved

Default
Space

Description
Any errors that occur are listed in the parameter RETURN.