# 创建申报

**POST /declarations**

创建新的申报


## Servers
- production: https://app.gutline.eu/api/v1 (production)
- sandbox: https://app-sandbox.gutline.eu/api/v1 (sandbox)


## Authentication methods
- Bearer auth


## Parameters



### Body: application/json (object)

- **client_ref** (string)
  客户参考号 (8-32 位，仅包含字母、数字、连字符和下划线)
- **lrn** (string)
  申报参考号 (8-32 位，仅包含字母、数字、连字符和下划线)

  **注意**: 目前系统都支持自定义，但不保证未来所有系统都支持
- **template_code** (string)
  申报模板代码 (8-32 位，仅包含字母、数字、连字符和下划线)
- **declaration_type** (string)
  申报类型 (IM=进口，EX=出口)
- **additional_declaration_type** (string)
  附加申报类型 (A=标准申报，D=预申报)
- **presentation_mode** (string)
  呈报（确认）模式 (conditional, scheduled)
- **provisional_validation_datetime** (string(date-time))
  暂定确认时间（预申报场景）
- **declaration_office_code** (string)
  申报办公室代码 https://www.tariffnumber.com/offices
- **presentation_office_code** (string)
  呈报办公室代码
- **shipment_carrier_ref** (string)
  承运人参考号
- **mode_at_border** (string)
  边境运输方式
- **inland_mode** (string)
  内陆运输方式
- **country_of_dispatch_code** (string)
  出口国代码 (ISO3166 alpha2 代码)
- **country_of_destination_code** (string)
  进口国代码 (ISO3166 alpha2 代码)
- **gross_weight_in_kg** (number(float))
  总毛重（千克，必须大于 0）
- **total_packages** (integer)
  总包装数（必须大于 0）
- **unique_consignment_reference** (string)
  唯一托运参考号
- **location_of_goods_code** (string)
  货物位置代码 (3 位 IATA 机场代码或 UN/LOCODE 格式) https://datahub.io/core/un-locode
- **location_of_goods_type** (string)
  货物位置类型
- **location_of_goods** (object)
  货物位置详情
- **delivery_terms** (string)
  交货条款 https://www.trade.gov/know-your-incoterms
- **delivery_terms_location** (string)
  交货条款地点
- **currency_code** (string)
  货币代码 (ISO4217 三字母代码) https://www.iban.com/currency-codes
- **currency_exchange_rate** (number(float))
  汇率
- **ioss_number** (string)
  IOSS 号码 (10-16 位，仅包含字母、数字和连字符)
- **deferred_payment_account** (string)
  延期付款账户
- **importer** (object)

- **exporter** (object)

- **declarant** (object)

- **representative** (object)

- **documents** (array[object])
  相关文档
- **items** (array[object])
  商品明细 (1-999 个商品)
- **tax_lines** (array[object])
  税金明细


## Responses
### 201
申报创建成功

#### Body: application/json (object)
- **id** (integer(int64))

- **reference** (string)
  系统生成的申报号
- **client_ref** (string)
  客户参考号 (8-32 位，仅包含字母、数字、连字符和下划线)
- **lrn** (string)
  申报参考号 (8-32 位，仅包含字母、数字、连字符和下划线)

  **注意**: 目前系统都支持自定义，但不保证未来所有系统都支持
- **mrn** (string)
  参考号（海关返回）
- **template_code** (string)
  申报模板代码 (8-32 位，仅包含字母、数字、连字符和下划线)
- **declaration_type** (string)
  申报类型 (IM=进口，EX=出口)
- **additional_declaration_type** (string)
  附加申报类型 (A=标准申报，D=预申报)
- **presentation_mode** (string)
  呈报（确认）模式 (conditional, scheduled)
- **provisional_validation_datetime** (string(date-time))
  暂定确认时间（预申报场景）
- **declaration_office_code** (string)
  申报办公室代码 https://www.tariffnumber.com/offices
- **presentation_office_code** (string)
  呈报办公室代码
- **shipment_carrier_ref** (string)
  承运人参考号
- **mode_at_border** (string)
  边境运输方式
- **inland_mode** (string)
  内陆运输方式
- **country_of_dispatch_code** (string)
  出口国代码 (ISO3166 alpha2 代码)
- **country_of_destination_code** (string)
  进口国代码 (ISO3166 alpha2 代码)
- **gross_weight_in_kg** (number(float))
  总毛重（千克，必须大于 0）
- **total_packages** (integer)
  总包装数（必须大于 0）
- **unique_consignment_reference** (string)
  唯一托运参考号
- **location_of_goods_code** (string)
  货物位置代码 (3 位 IATA 机场代码或 UN/LOCODE 格式) https://datahub.io/core/un-locode
- **location_of_goods_type** (string)
  货物位置类型
- **location_of_goods** (object)
  货物位置详情
- **delivery_terms** (string)
  交货条款 https://www.trade.gov/know-your-incoterms
- **delivery_terms_location** (string)
  交货条款地点
- **currency_code** (string)
  货币代码 (ISO4217 三字母代码) https://www.iban.com/currency-codes
- **currency_exchange_rate** (number(float))
  汇率
- **ioss_number** (string)
  IOSS 号码 (10-16 位，仅包含字母、数字和连字符)
- **deferred_payment_account** (string)
  延期付款账户
- **status** (string)
  申报状态。注意：一旦提交到海关，状态将不可逆地改变
- **reject_reason** (string)
  拒绝原因
- **importer** (object)

- **exporter** (object)

- **declarant** (object)

- **representative** (object)

- **documents** (array[object])
  相关文档
- **items** (array[object])
  商品明细 (1-999 个商品)
- **tax_lines** (array[object])
  税金明细
- **tax_assessment_notice_url** (string)
  PDF 税单链接
- **created_at** (string(date-time))
  创建时间
- **updated_at** (string(date-time))
  更新时间
- **scheduled_at** (string(date-time))
  计划时间
- **submitted_at** (string(date-time))
  提交时间
- **accepted_at** (string(date-time))
  接受时间
- **inspected_at** (string(date-time))
  查验时间
- **finalized_at** (string(date-time))
  完结时间
- **released_at** (string(date-time))
  放行时间
- **cancelled_at** (string(date-time))
  取消时间
- **goods_presentation_due_date** (string(date))
  货物呈报截止日期
- **goods_presentation_effective_date** (string(date-time))
  货物呈报生效日期
- **cancellation_requested_at** (string(date-time))
  取消请求时间
- **rejected_at** (string(date-time))
  拒绝时间

### 400
请求参数错误

#### Body: application/json (object)
- **error** (string)

- **errors** (object)


### 401
未授权

### 422
验证失败

#### Body: application/json (object)
- **error** (string)

- **errors** (object)



[Powered by Bump.sh](https://bump.sh)