External Fulfillment Errors
Learn how to interpret External Fulfillment errors
This table details error codes used by External Fulfillment APIs, and the appropriate remediation steps:
HTTP code | External Fulfillment error code | Short error code | Error message | Remediation steps |
---|---|---|---|---|
500 | SC_00000 | InternalFailure | Internal failure occurred, contact Amazon Support. | Contact Amazon Support with API logs and error details. |
503 | SC_00001 | ServiceUnavailable | Temporary failure occurred, retry operation | Wait and try again. If still unsuccessful, implement exponential backoff. |
429 | SC_00007 | RateLimited | Temporary failure occurred, retry operation after some time. | Check the rate limits and adhere to them. |
400 | SC_00002 | InvalidInput | Invalid input '%s' for parameter '%s' | Enter parameter format is correct. Validate input before sending. |
400 | SC_00002 | InvalidInput | Invalid input, '%s': '%s' can't be higher than '%s' | Review business logic in the request. Ensure comparative values are valid. |
400 | SC_00002 | InvalidInput | At least one field is mandatory in the input payload | Include required fields in request payload. |
404 | SC_00003 | NotFound | Requested Entity with '%s' '%s' is not found. | Verify that the entity or shipment exists. Check if you have correct access permissions to retrieve shipment details for the seller. |
404 | SC_00003 | NotFound | Requested artifact of type '%s' not found | Confirm that the document exists and you have correct access permissions. Check that the document type is correct. |
409 | SC_00004 | DuplicateRequest | Duplicate clientToken exists for '%s' '%s' | Use a unique clientToken or sequenceNumber . Check if the request was already processed successfully. |
409 | SC_00004 | DuplicateRequest | Requested operation is already in progress for '%s' '%s' | Wait for the current operation to complete. Check operation status before retrying. |
403 | SC_00005 | Forbidden | Request is forbidden | Check authentication credentials and SP-API roles permissions. Ensure that the API key has necessary access rights. |
409 | SC_10000 | ServerBusy | Requested operation will be ignored as workflow is already processing other request(s) | Wait for the current workflow to complete. Implement retry mechanism with appropriate delay. |
400 | SC_10001 | OperationNotPermitted | Requested operation is not permitted in the current order state | Check current order status with the getShipment operation. Follow correct order processing workflow. |
400 | SC_20000 | InvalidInput | Requested quantity '%s' is more than existing inventory quantity '%s' | Ensure that the order is not cancelled. Validate the lineItemId and corresponding quantity, and correct accordingly. |
409 | SC_20002 | StateConflict | %s is in conflict with existing client sequence number %s | Use increasing sequence numbers. Sync the latest sequence number before retry. |
412 | SC_00006 | StateConflict | Entity Version '%s' is in conflict with existing entity version '%s' | Retrieve the latest entity version before update using If-Match or If-Unmodified-Since headers. Update the latest entity version or timestamp. |
422 | SC_00006 | OrderCancelled | Cannot process the request because the order is already cancelled | Check the order status before processing. Handle cancelled orders appropriately in your workflow. |
400 | SC_30001 | ShiplabelGenerationFailure | Cannot process the request because either package dimensions are incorrect or the carrier capacity has been completely utilized | Verify the input package dimensions. Try different package dimensions using the updatePackage operation or wait for carrier capacity to be available. |
400 | SC_30002 | TransCapacityBreachedFailure | The capacity for the site is breached | Try processing after the current EXSD or wait for carrier capacity to be available. |
400 | SC_30003 | IncorrectPackageDimensionsFailure | Package dimensions or weight is incorrect | Ensure that the dimensions are within the channel and carrier limits. Verify and update accordingly. |
400 | SC_30004 | InvalidInput | The given pickup-slot is no longer available and is expired | Select a new pickup slot. Implement real-time slot availability check. |
400 | SC_30005 | StateConflict | Dispatch-after-date '%s' of the order is greater than the current time | Wait until dispatch-after-date before processing. Schedule processing for correct time. |
409 | SC_40000 | DuplicateRequest | An event subscription already exists for the merchant | Check existing subscriptions before creating new ones. Update existing subscription if needed. |
400 | SC_30007 | OperationNotPermitted | No invoice available for shipment '%s' | Wait for invoice availability. Check the invoice status using getShipment or getShipments . Applicable for the BR marketplace. |
400 | SC_00005 | InvalidInput | Maximum number of retry reached for order '%s' or on a operation of order, Please try after '3600' seconds. | Wait for one hour (3600 seconds) before attempting the operation again. Meanwhile, verify and correct any bad input to ensure successful processing on the next attempt. |
Updated about 2 hours ago