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 codeExternal Fulfillment error codeShort error codeError messageRemediation steps
500SC_00000InternalFailureInternal failure occurred, contact Amazon Support.Contact Amazon Support with API logs and error details.
503SC_00001ServiceUnavailableTemporary failure occurred, retry operationWait and try again. If still unsuccessful, implement exponential backoff.
429SC_00007RateLimitedTemporary failure occurred, retry operation after some time.Check the rate limits and adhere to them.
400SC_00002InvalidInputInvalid input '%s' for parameter '%s'Enter parameter format is correct. Validate input before sending.
400SC_00002InvalidInputInvalid input, '%s': '%s' can't be higher than '%s'Review business logic in the request. Ensure comparative values are valid.
400SC_00002InvalidInputAt least one field is mandatory in the input payloadInclude required fields in request payload.
404SC_00003NotFoundRequested 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.
404SC_00003NotFoundRequested artifact of type '%s' not foundConfirm that the document exists and you have correct access permissions. Check that the document type is correct.
409SC_00004DuplicateRequestDuplicate clientToken exists for '%s' '%s'Use a unique clientToken or sequenceNumber. Check if the request was already processed successfully.
409SC_00004DuplicateRequestRequested operation is already in progress for '%s' '%s'Wait for the current operation to complete. Check operation status before retrying.
403SC_00005ForbiddenRequest is forbiddenCheck authentication credentials and SP-API roles permissions. Ensure that the API key has necessary access rights.
409SC_10000ServerBusyRequested 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.
400SC_10001OperationNotPermittedRequested operation is not permitted in the current order stateCheck current order status with the getShipment operation. Follow correct order processing workflow.
400SC_20000InvalidInputRequested 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.
409SC_20002StateConflict%s is in conflict with existing client sequence number %sUse increasing sequence numbers. Sync the latest sequence number before retry.
412SC_00006StateConflictEntity 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.
422SC_00006OrderCancelledCannot process the request because the order is already cancelledCheck the order status before processing. Handle cancelled orders appropriately in your workflow.
400SC_30001ShiplabelGenerationFailureCannot process the request because either package dimensions are incorrect or the carrier capacity has been completely utilizedVerify the input package dimensions. Try different package dimensions using the updatePackage operation or wait for carrier capacity to be available.
400SC_30002TransCapacityBreachedFailureThe capacity for the site is breachedTry processing after the current EXSD or wait for carrier capacity to be available.
400SC_30003IncorrectPackageDimensionsFailurePackage dimensions or weight is incorrectEnsure that the dimensions are within the channel and carrier limits. Verify and update accordingly.
400SC_30004InvalidInputThe given pickup-slot is no longer available and is expiredSelect a new pickup slot. Implement real-time slot availability check.
400SC_30005StateConflictDispatch-after-date '%s' of the order is greater than the current timeWait until dispatch-after-date before processing. Schedule processing for correct time.
409SC_40000DuplicateRequestAn event subscription already exists for the merchantCheck existing subscriptions before creating new ones. Update existing subscription if needed.
400SC_30007OperationNotPermittedNo invoice available for shipment '%s'Wait for invoice availability. Check the invoice status using getShipment or getShipments. Applicable for the BR marketplace.
400SC_00005InvalidInputMaximum 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.