Seller Protection and Publication Journal
Before the merchantCENTRAL Connector for eBay creates, changes, publishes, ends or deletes a listing, it checks that it works for the right eBay seller and touches only listings that belong to Business Central. Every one of these writes is recorded in the eBay Publication Journal. This page explains the setup, the administrator actions and what to do when the protection stops a write.
After the update from version 1.19
Accounts from 1.19 do not have a verified seller yet. Until an administrator verifies it, the connector sends no listing, price or quantity updates for that account; the eBay Dashboard then shows the hint Seller Verification Required. Once per account:
- Verify the seller identity.
- Capture source generations, so that listings assigned earlier can be delisted and their items deleted.
Where the actions are
All actions are on the eBay setup in the eBay Accounts part and apply to the account selected there. They need the right to modify the eBay accounts (permission set mC eBay - Admin).
| Action | Effect |
|---|---|
| Verify Seller Identity | Asks eBay which seller the credentials belong to and binds the account to it. |
| Capture Source Generations | Binds assigned listings that cannot prove their owner yet to the verified seller. |
| Reset Seller Binding | Removes the binding so that another seller or the other eBay environment can be verified. |
| Native Identity History | Shows earlier assignments and the workflow for legacy assignments. |
| Publication Journal | Shows the writes of this account, see Publication Journal. |
Verify the seller identity
Verify Seller Identity asks eBay, with the stored credentials, for the seller's immutable identifier. Only a hash of it is stored, together with account, company, tenant and environment. In the eBay Completion Evidence dialog you enter an Evidence Reference and set Evidence Verified. The reference documents that older programs which published listings for this seller have been switched off.
- Verifying the same seller again changes none of the existing assignments.
- If the credentials answer for a different seller, the connector refuses and leaves everything unchanged. Reset the binding first.
- Verification is not possible in Simulation Mode or with a Base URL or Auth URL Override.
When the protection stops a write because the verification is missing, the error names the account and offers Verify Seller Identity directly.
New credentials for a verified account (for example after a new eBay consent) are stored only when they provably belong to the same seller.
Capture source generations
To delist a listing and delete its Business Central item, the assignment must prove which seller and which item it belongs to. Assignments from 1.19, assignments made before the verification and assignments of another seller cannot. For them: no delisting, and the item cannot be deleted.
Capture Source Generations counts these assignments, asks for confirmation and an evidence reference. Then the connector
- checks the seller once with eBay,
- reads every listing exactly from eBay: offer ID, SKU, marketplace and eBay listing ID must match the assignment,
- binds only the matching assignments to the verified seller and the current Business Central item.
Nothing is changed on eBay. At the end the action reports how many assignments were captured and how
many were not proven and left unchanged. A listing stays unproven, for example, when it no longer
exists on eBay or now carries another SKU; synchronize the eBay listings first.
Every run is recorded with its evidence reference in the Publication Journal (method CAPTURE).
For a single listing the same action is available as Capture Source Generation on the eBay listings page.
Reset the seller binding
Reset Seller Binding removes the account's binding, for example when moving from the eBay sandbox
to production or after the eBay account was recreated. The action asks for a reason and is then
recorded in the Publication Journal (method RESET).
It is refused while
- the outcome of a write of this seller is unknown,
- a delisting is running, or
- the audit of a legacy assignment is pending.
Afterwards all protected writes of the account stop until the next verification. If the same seller is verified again, the captured assignments stay valid. For another seller or the other eBay environment, capture the source generations again.
The Publication Journal
The eBay Publication Journal records every protected write: account, marketplace, method, endpoint, start and end time, HTTP status and the outcome.
| State | Meaning |
|---|---|
| Outcome Unknown | The call reached eBay, but the answer is missing — for example after a timeout. While such an entry is open, the connector sends no further writes for this seller. |
| Completed | eBay answered. A refusal by eBay is completed, too. |
| Rejected Before Dispatch | The protection stopped the call before anything went to eBay. The reason is in the error of the process that started it. |
| Reconciled with Evidence | An administrator closed an unknown outcome with evidence, or it is an administration entry (RESET, CAPTURE). |
A missing answer to a pure update — item data, offer, price and quantity, or a variation group — is completed by the connector itself: sending the same update again yields the same state, and no listing can appear or disappear by it. The entry then carries a note, and the next synchronization sends the data again. Outcome Unknown remains only for creating, publishing, ending and deleting a listing.
Reconcile an unknown outcome
Reconcile with Evidence closes an entry with Outcome Unknown. It needs proof from eBay that exactly this operation was carried out, rejected or cancelled, the Confirmed Operation ID from the journal and an Evidence Reference. That the listing is currently not in the catalogue is not proof. Reconciling is possible only after the session that sent the call has ended.
What the connector checks before sending
- Before every write the connector reads all eBay offers of the affected SKU, each addressed offer on its own and, for variation groups, the group. Every offer of that SKU must have an assignment in Business Central. Otherwise nothing is sent.
- Before creating and publishing it also checks the seller's complete catalogue on eBay, including listings created through the Trading API. Within a run (job queue entry or session) this check stays valid for 30 minutes; it is repeated earlier as soon as another session writes for the same seller.
- Before ending and deleting it always checks the complete catalogue.
Listings without SKU that were created outside Business Central no longer stop any write.
If eBay does not answer in time during a delisting (timeout, throttling, server error), the delisting waits and retries by itself. After 20 runs of a target it goes to you; retry it manually then.
Resolve legacy assignments
A legacy assignment is an earlier assignment without provable owner whose listing no longer exists on eBay. While it is open, the item cannot be deleted. If the listing is still live, rather capture the source generation and delist it normally.
- On the eBay listings page choose Review Legacy Identity, or open the Native Identity History.
- Resolve Legacy Assignment: enter the evidence reference, attach the document with Upload Evidence Document and set Original Seller and Source Verified.
- The connector checks with eBay that neither the offer nor the SKU still exist. During this audit (Audit Pending) it sends no writes for the seller.
- If the audit succeeds, the resolution is Absence Verified and the item can be deleted. Until then the SKU is not published again.
On the Legacy Resolutions page:
| Action | Effect |
|---|---|
| Resume Read-only Audit | Repeats the audit with the same evidence. |
| Withdraw Resolution | Ends a resolution with a logged reason — for example because the old listing is still live after all. The freeze ends, but the item stays protected until a new resolution or a normal delisting succeeds. |
If the connector later reads the listing from eBay again, the resolution becomes Evidence Contradicted. Then only this SKU is not published; withdraw the resolution or resolve it again.
Tips
- Verify a new account right after the first eBay consent. Without verification the connector sends no listings.
- An open Outcome Unknown entry stops all writes of the seller — including those of the other countries of the same eBay account. Resolve it first.
- After a change of the eBay keyset (new Client ID) the captured assignments stay valid, but resolved legacy assignments have to be proven again.