Skip to content
HALOWERK

Ortwerk

returns rules

Text basis: BGB as published on gesetze-im-internet.de (retrieved 2026-11-01). Right of withdrawal for distance and off-premises contracts (§ 312g Abs. 1) unless one of the 13 exceptions of § 312g Abs. 2 applies. The 14-day period (§ 355 Abs. 2) starts with receipt of the goods (§ 356 Abs. 2 Nr. 1 a), of the last item or part delivery (b, c), of the first delivery for subscriptions (d), or with conclusion for services and digital content; not before compliant information (§ 356 Abs. 3). The.

POST https://ort.halowerk.com/v1/returns-rules

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
contract_typeSee schemaYesgoods_separate_deliveries: several goods of one order delivered separately; goods_partial_shipments: one good in several parts; digital_content: not on a physical medium.
conclusionSee schemaNo
contract_datestringYes
receipt_datestringNoDate the consumer (or a named third person, not the carrier) received the goods – the last item/part, or the first item for subscriptions.
withdrawal_informationSee schemaNo
information_datestringNoRequired when withdrawal_information is "later".
exceptionSee schemaNo§ 312g Abs. 2 Nr. 1-13 if one applies.
withdrawal_sent_datestringNo
withdrawal_received_datestringNo
return_costs_informedbooleanNoConsumer was informed that they bear the direct return costs.
trader_pays_returnbooleanNo
trader_offers_pickupbooleanNo
consumer_stateSee schemaNoGerman state of the consumer, for regional holidays under § 193.
online_interfacebooleanNoContract concluded via an online user interface (§ 356a).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "contract_type",
    "contract_date"
  ],
  "properties": {
    "contract_type": {
      "enum": [
        "goods",
        "goods_separate_deliveries",
        "goods_partial_shipments",
        "goods_subscription",
        "services",
        "digital_content"
      ],
      "description": "goods_separate_deliveries: several goods of one order delivered separately; goods_partial_shipments: one good in several parts; digital_content: not on a physical medium."
    },
    "conclusion": {
      "enum": [
        "distance",
        "off_premises"
      ],
      "default": "distance"
    },
    "contract_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "receipt_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date the consumer (or a named third person, not the carrier) received the goods – the last item/part, or the first item for subscriptions."
    },
    "withdrawal_information": {
      "enum": [
        "at_conclusion",
        "later",
        "never"
      ],
      "default": "at_conclusion"
    },
    "information_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Required when withdrawal_information is \"later\"."
    },
    "exception": {
      "enum": [
        "custom_made",
        "perishable",
        "sealed_hygiene_unsealed",
        "inseparably_mixed",
        "alcohol_market_price",
        "sealed_media_unsealed",
        "newspapers",
        "financial_market",
        "dated_leisure_service",
        "public_auction",
        "urgent_repairs",
        "betting_lottery",
        "notarised"
      ],
      "description": "§ 312g Abs. 2 Nr. 1-13 if one applies."
    },
    "withdrawal_sent_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "withdrawal_received_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "return_costs_informed": {
      "type": "boolean",
      "default": true,
      "description": "Consumer was informed that they bear the direct return costs."
    },
    "trader_pays_return": {
      "type": "boolean",
      "default": false
    },
    "trader_offers_pickup": {
      "type": "boolean",
      "default": false
    },
    "consumer_state": {
      "enum": [
        "BB",
        "BE",
        "BW",
        "BY",
        "HB",
        "HE",
        "HH",
        "MV",
        "NI",
        "NW",
        "RP",
        "SH",
        "SL",
        "SN",
        "ST",
        "TH"
      ],
      "description": "German state of the consumer, for regional holidays under § 193."
    },
    "online_interface": {
      "type": "boolean",
      "default": false,
      "description": "Contract concluded via an online user interface (§ 356a)."
    }
  }
}

Open original schema

Published input example

{
  "contract_type": "goods",
  "contract_date": "2026-10-30",
  "receipt_date": "2026-11-02"
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →