销售入库/退货单列表

• HTTP请求

  GET /api/sales.json

• 请求参数

• 返回字段说明

• 返回 JSON 数据

    {
    "status": {
        "code": 200,
        "message": "OK"
    },
    "sales": [
        {
            "id": 15546,
            "number": "XSCKD201804250002",
            "type": "sale",
            "type_name": "销售出库单",
            "category": "out",
            "amount": "58.50000",
            "warehouse_id": 3905,
            "warehouse_name": "GGGGG",
            "customer_or_supplier_name": "国金",
            "purchaser_or_seller_name": "谢芝林",
            "status": "审批通过",
            "status_value": "passed",
            "creator": "谢芝林",
            "operator": "谢芝林",
            "operated_at": "2018-04-25 20:04",
            "created_at": "2018-04-25 20:03",
            "next_status": null,
            "entry_or_io_at": "2018-04-25",
            "created_at": "2023-07-20 16:13:11",
              "updated_at": "2023-07-20 16:13:11",
            "seller_name": "谢芝林"
        },
            { ... }
        ]
    }

销售出库/退货单新增

• HTTP请求

  POST /api/sales.json

• 请求参数

• 返回字段说明

  字段 | 类型 | 说明
  — | — | —
  id | integer | 单据ID
  category | string | 类别

• 返回 JSON 数据

    {
        "status": {
            "code": 200,
             "message": "OK"
        },
        "sale": {
            "id" :61868,
            "category": "out"
        }
    }

销售出库/退货单详情

curl -H "Authorization: Token token=<token>, uid=<uid>" \
  http://example.com/api/sales/:id.json

{
    "status": {
        "code": 200,
        "message": "OK"
    },
    "sale": {
        "id": 735,
        "category": "out",
        "approved_level": 0,
        "status": "approving",
        "creator_name": "XXX",
        "sale_order_id": null,
        "type_name": "销售出库单",
        "copy_to_member_names": [],
        "copy_to": [],
        "parent_id": null,
        "parent_number": null,
        "print_count": 0,
        "discount": "0.0",
        "deduction": "0.0",
        "amount": "11.6",
        "total_quantity": "1.0",
        "total_base_quantity": null,
        "total_fee_amount": "0.0",
        "number": "XSCKD201903290001",
        "io_at": "2019-03-29",
        "customer_id": 2,
        "customer_name": "客户1",
        "seller_id": 1,
        "seller_name": "XXX",
        "note": null,
        "contact_id": 75,
        "contact_name": "张三",
        "contact_mobile": "13612345678",
        "contact_phone": "4561321654",
        "contact_address": "asf2wer",
        "customer_address": "儿童问题",          
        "has_approve_permission": true,
        "has_revoke_permission": true,
        "sensitive_access": true,
        "contact_sensitive_access": true,
        "customer_sensitive_access": true,
        "note_editable": true,
        "attachment_editable": true,
        "allow_negative_inventory": true,
        "gt_order_quantity": true,
        "total_deduction": "0.0",
        "total_amount": "10.0",
        "total_tax_amount": "1.6",
        "total_amount_with_tax": "11.6",
        "status_i18n": "待1级审批",
        "created_at": "2019-03-29",
        "sale_order_number": null,
        "children": [],
        "has_serial_code": false,
        "document_addition_id": 378,
        "product_items": [
            {
                "id": 1392,
                "product_id": 1,
                "product_attr_group_id": 1,
                "product_unit_id": 131,
                "product_item_id": null,
                "parent_id": null,
                "name": "测试商品1",
                "product_number": "DG001",
                "attr_names": "",
                "spec": "XS",
                "unit": "个",
                "quantity": "1.0",
                "price": "10.0",
                "price_with_tax": "11.6",
                "discount": "0.0",
                "deduction": "0.0",
                "amount": "10.0",
                "tax_rate": "16.0",
                "tax_amount": "1.6",
                "amount_with_tax": "11.6",
                "batch_id": null,
                "batch_number": null,
                "expired_at": null,
                "produced_at": null,
                "modified": "quantity",
                "product_images": [],
                "warehouse_id": 25,
                "warehouse_name": "名字很长很长很长的仓库",
                "base_unit": "",
                "base_quantity": null,
                "deputy_unit_quantity": "",
                "note": "aa",
                "serial_code_status": "serial_closed",
                "order_number": null,
                "product_image": "",
                "serial_codes_attributes": []
            }
        ],
        "fees": [],
        "attachments": [],
        "allow_add_other": false,
        "custom_number_setting": "auto",
        "approval_information": {},
        "document_approvers": [
            {
                "level": 1,
                "status": "approving",
                "mode": "single",
                "name": "XXX"
            }
        ]
    }
}

• HTTP请求

  GET /api/sales/:id.json

• 请求参数

  无

• 返回字段说明

编辑销售单

curl -i -X PUT --header "Authorization: Token token=<user_token>, uid=<uid>" \
  http://example.com/api/sales/:id.json

{
  "status": {
    "code": "200",
    "message": "OK"
  },
  "sale": {
    "id": 57,
    "category": "out"
  }
}

• HTTP请求

  PUT /api/sales/:id.json

• 请求参数

• 返回字段说明

销售出库/退货单获取自动编号

• HTTP请求

  GET /api/sales/get_auto_number.json

• 请求参数

• 返回字段说明

• 返回 JSON 数据

    {
        "status": {
            "code": 200,
            "message": "OK"
        },
        "number": "XSD20180528001"
    }