Более четкий ответ от BigCommerce

Может ли BigCommerce изменить свой ответ API, чтобы он был более четким, когда программа пытается опубликовать уже существующую отправку?

При отправке отправлений в BigCommerce, если отправление уже существует, вы получаете следующее сообщение об ошибке.

<?xml version="1.0"?>
<errors>
    <error>
        <status>400</status>
        <message>The field 'quantity' is invalid.</message>
        <details>
            <invalid_reason>The quantity specified is greater than the quantity of the product that is available to ship.</invalid_reason>
            <available_quantity>0</available_quantity>
            <order_product_id>628</order_product_id>
        </details>
    </error>
</errors>

Я согласен, что это плохой запрос, но он не имеет ничего общего с количеством товара. Можем ли мы вместо этого сделать что-то вроде следующего для message или invalid_reason?

The shipment [insert ID here] already exists and cannot be added.

Это сделало бы API гораздо более удобным.


api httpresponse bigcommerce api-design
person Ryan Gates    schedule 26.07.2013    source источник
comment
Я корил себя, пытаясь понять, что, черт возьми, происходит. Это глупое сообщение для них в данном случае. Я предполагаю, что лучший способ проверить, подтверждена ли уже отправка, - это сначала перечислить поставки заказа (или после обнаружения ошибки).   -  person William W    schedule 27.03.2014

Ответы (1)


arrow_upward
2
arrow_downward

При запросе ресурса продуктов заказа имеется доступное количество для отправки, и когда вы создаете отгрузки, доступное количество уменьшается до 0.

Первоначально отправка POST отгрузки проходит успешно, поскольку количество, указанное в полезной нагрузке, совпадает с количеством в заказе. Если вы должны были отправить отгрузку в заказ, который уже был отправлен, тогда доступное количество фактически равно 0, и когда вы указываете положительное целое число для количества в полезной нагрузке, оно недействительно и превышает доступное количество, поэтому ошибка является точной. .

person adambil    schedule 27.03.2014
comment
Было бы здорово, если бы это было где-нибудь задокументировано, а сообщение об ошибке не подразумевало бы, что общее количество товара равно нулю. Это все еще очень вводящая в заблуждение ошибка. Как насчет того, что указанное количество больше, чем количество продукта, запрошенного для этого заказа? - person William W; 28.03.2014