Bottle deposit (German: Pfand) applies to products sold in certain single-use or multi-use containers. Buyers will not specifically order bottle deposit items but require bottle deposits as separate line items on invoices. Connectors will therefore be able to handle bottle deposits according to the following rules:

​
Rules

  1. Per order line item of a product that is subject to bottle deposit, the connector ensures that a second “deposit order line” containing the bottle deposit is added immediately following the original order line.
  2. The deposit product used for the “deposit order line” must:
    1. Have its own valid EAN/GTIN code
    2. Correspond directly to 1 unit of the product ordered. That means, if single PET bottles are ordered, the deposit product (at the time of writing) would be 0.25€ but if full crates of mineral water are ordered, the deposit product (at the time of writing) would be 3.30€ (1.50€ for the crate + 12*0.15€ for the bottles)
  3. The “deposit order line” has to have the exact same quantity as the original order line.

​
Examples

Below, you can see how to use bottle deposits when sending orders or invoices.

​
Sending Orders

"items": [
  {
    "lineNumber": 1,
    "identifiers": [...],
    "isDepositItem": false,
    "quantity": 20,
    "unitOfMeasure": "EA",
    "description": "Water PET-Bottle 1l"
  },
  {
    "lineNumber": 2,
    "identifiers": [...],
    "isDepositItem": true,
    "quantity": 20,
    "unitOfMeasure": "EA",
    "description": "Bottle Deposit PET",
    "unitPrice": 0.12
  }
]

​
Sending Invoices

For invoices, bottle deposits can also be added as sub items for grouping purposes. 
"items": [
  {
    "lineNumber": 1,
    "identifiers": [...],
    "isDepositItem": false,
    "isInvoicedItem": false,
    "quantity": 20,
    "unitOfMeasure": "EA",
    "description": "Water PET-Bottle 1l",
    "unitPrice": 0,
    "subItems": [
      {
        "lineNumber": 2,
        "identifiers": [...],
        "isDepositItem": false,
        "isInvoicedItem": true,
        "quantity": 20,
        "unitOfMeasure": "EA",
        "description": "Water PET-Bottle 1l",
        "unitPrice": 0.84,
        "tax": {
          "amount": 0.16,
          "percentage": 19
        }
      },
      {
        "lineNumber": 3,
        "identifiers": [...],
        "isDepositItem": true,
        "isInvoicedItem": true,
        "quantity": 20,
        "unitOfMeasure": "EA",
        "description": "Bottle Deposit PET",
        "unitPrice": 0.12,
        "tax": {
          "amount": 0.03,
          "percentage": 19
        }
      }
    ]
  }
]