Налоги: taxes¶
Ресурс | Описание |
---|---|
GET /taxes | Получить список налогов |
GET /taxes/:id | Получить данные о налоге |
POST /taxes/ | Создать налог |
PUT /taxes/:id | Обновить налог |
DELETE /taxes/:id | Удалить налог |
GET /taxes¶
curl -X GET 'http://example.com/api/2.0/taxes'
[
{
"tax_id": "6",
"address_type": "S",
"status": "A",
"price_includes_tax": "Y",
"display_including_tax": "N",
"display_info": "",
"regnumber": "1234242",
"priority": "0",
"tax": "VAT"
},
{
"tax_id": "7",
"address_type": "S",
"status": "A",
"price_includes_tax": "Y",
"display_including_tax": "N",
"display_info": "",
"regnumber": "1234242",
"priority": "0",
"tax": "VAT2"
}
]
GET /taxes/:id¶
curl -X GET 'http://example.com/api/2.0/taxes/6'
{
"tax_id": "6",
"address_type": "S",
"status": "A",
"price_includes_tax": "Y",
"display_including_tax": "N",
"display_info": "",
"regnumber": "1234242",
"priority": "0",
"tax": "VAT"
}
POST /taxes/¶
Данные должны приходить в теле HTTP запроса в соответствии с переданным Content-type
.
В случае, если налог создать не удалось, будет возвращен статус HTTP/1.1 400 Bad Request.
В случае успеха будет возвращён статус HTTP/1.1 201 Created.
Обязательные параметры: tax.
curl --header 'Content-type: application/json' -X POST 'http://example.com/api/2.0/payments' --data-binary '...'
{
"address_type": "S",
"status": "A",
"price_includes_tax": "Y",
"display_including_tax": "N",
"display_info": "",
"regnumber": "1234242",
"priority": "0",
"tax": "VAT2"
}
Результат
{
"tax_id": "7"
}
PUT /taxes/:id¶
Данные должны приходить в теле HTTP запроса в соответствии с переданным Content-type
.
В случае, если налог обновить не удалось, будет возвращен статус HTTP/1.1 400 Bad Request.
curl --header 'Content-type: text/plain' -X PUT 'http://example.com/api/2.0/taxes/6' --data-binary 'status=D'
{
"tax_id": "6",
}
DELETE /taxes/:id¶
В случае, если налог удалить не удалось, будет возвращен статус HTTP/1.1 400 Bad Request.
В случае, если такой налог не существует, будет возвращен статус HTTP/1.1 404 Not Found.
В случае успеха будет возвращён статус HTTP/1.1 204 No Content.
curl -X DELETE 'http://example.com/api/2.0/taxes/3'