Submit or cancel inbound approval

An inbound document in Bulk is the record you build from a customer's incoming order, including its parts, quantities, routings and forms, before that work becomes production jobs. Submitting a document is how you hand it off for sign-off: when any routing used on the document requires approval, submitting raises an approval request and locks the document so nobody can change it while it waits for a decision.

You submit a document once you have reviewed its items and they are all ready. If you submitted too early, or an approver asks for something you would rather fix yourself, you cancel the pending approval by withdrawing it. Cancelling removes the sign-off gate and returns the document to an editable state, so you can correct it and submit again. This page explains how the submitter sends a document for approval and withdraws a pending request.

Before you startCopy Anchor Link

To submit a document you need the Submit inbound documents permission (inbound_documents.submit). In Bulk's default roles this is granted to Operator, Manager, Entity admin, and Super user. If Submit to production is missing from the header, your role or the document's status may prevent submission. The confirmation dialog also checks item readiness.

The document must also be in the right shape before it can go for sign-off. When you submit, Bulk checks that:

• the document is In progress (not a draft, and not already submitted, approved, or closed);
• a customer and a currency are set on the document;
• the document has at least one item;
• every item is marked ready and uses an approved process; and
• any required forms for the document are filled in.

If any check fails, the submission is refused and the reason is shown, so you can fix it and try again. Getting items to the ready state is covered in Review an inbound document.

Submit a document for approvalCopy Anchor Link

1. Open Inbound → Inbound Documents from the navigation and open the document you want to submit.
2. In the document header, select Submit to production.
3. Bulk opens the Confirm Submission dialog. It lists your items grouped into Not Ready and Ready to Submit, with a count of each. Every item must be ready and use an approved process, so the Not Ready group is shown first with the reason each item is blocked.
4. When all items are ready, select the final workflow action to confirm: Submit for Approval when a routing needs sign-off, or Submit to Production when it does not.

What happens next depends on the routings your items use:

• A routing requires approval. After the background submission checks finish, the document moves to a pending approval state and is locked: you and everyone else can view it but not edit it. The confirmation reads Submitted for Approval, and an Awaiting approval card appears in the approval band directly below the document header, showing who submitted it and which approvers it is waiting on. Because you submitted it, you cannot approve it yourself.
• No routing requires approval. There is no sign-off step. Submitting validates the items and queues production-job creation after approval. See Promote inbound work to production.

Cancel a pending approval (withdraw)Copy Anchor Link

If you submitted the document, you can cancel its pending approval request by withdrawing it. Withdrawing removes the sign-off gate and hands the document back to you.

1. Open the document that is awaiting approval. The approval band sits directly below the document header.
2. On the Awaiting approval card, select Withdraw.

Once you withdraw, the approval request is cancelled. When all of the document's requests are withdrawn, the document returns to In progress and unlocks, so you can edit its items and submit it again when it is ready. Nothing you entered is lost: withdrawing only removes the pending sign-off.

Example: Wayne EnterprisesCopy Anchor Link

The Gotham Applied Sciences team at Wayne Enterprises receives a rush order from a rail customer for 40 welded guardrail brackets. Bruce Wayne builds the inbound document, sets the customer and currency, adds the bracket items, and marks each one ready. Because the Welding routing at Gotham is configured to require approval, Bruce opens the document, selects Submit to production, reviews the Confirm Submission dialog, checks that all items sit under Ready to Submit, and chooses Submit for Approval. The document locks as pending approval and an Awaiting approval card appears, waiting on the welding supervisor. Because Bruce submitted it, Bruce cannot approve it.

A moment later Bruce spots that two brackets were entered with the wrong finish. Rather than ask the supervisor to reject the whole document, Bruce opens it, selects Withdraw on the Awaiting approval card, and the document drops back to In progress and unlocks. Bruce corrects the two items, marks them ready again, and submits a second time: now the supervisor sees the corrected document awaiting their sign-off.

What submitting and cancelling changeCopy Anchor Link

• Submitting locks the document. A document awaiting approval is read-only for everyone until it is approved, has changes requested, or is withdrawn.
• One request per required routing. If items use several routings that each require approval, Bulk raises a separate request per distinct routing, and the document is approved only once all of them are approved.
• Withdrawing is reversible and non-destructive. Cancelling a pending approval unlocks the document with all its data intact; you can edit and resubmit.
• The submitter is never an approver. Bulk excludes you from the approver list for anything you submit, so approvals always involve someone else.

TroubleshootingCopy Anchor Link

Submit to production is missing or the final action is disabled. The document must be In Progress and you must hold Submit inbound documents. Open the readiness summary to see incomplete items. The final workflow action stays disabled until every required check passes.

Confirm Submission says the document can't be submitted. If any item is not ready or does not use an approved process, the dialog shows a Cannot submit document warning and lists the blocked items under Not Ready with the reason for each. Fix those items: see Edit an inbound document. Mark them ready, then submit again.

Submitting is refused because the routing has no eligible approver. A routing that requires approval must list at least one approver who is not you, because you cannot approve your own document. If you are the only listed approver, the message asks you to add at least one other approver to this routing in Settings → Master data → Routings. Add an approver there, then submit again: see Manage routings.

Submitting is blocked by a customer status warning. If the document's customer is set to an operational status that blocks new inbound work, the Confirm Submission dialog shows the block and the final workflow action stays disabled. Resolve the customer's status, or use a customer that is clear to proceed.

Feature stateCopy Anchor Link

Submitting inbound documents and cancelling a pending approval by withdrawing are generally available. The sign-off step itself is routing-driven: it appears only for documents whose items use a routing configured to require approval. A document with no such routing is validated and turned into production jobs at the end of the submission workflow, with no approval to cancel. An administrator manages whether each routing needs approval, who can approve it and how many approvers must sign off.

RelatedCopy Anchor Link

• Inbound overview
• Review an inbound document
• Edit an inbound document
• Put inbound work on hold
• Promote inbound work to production
• Manage routings