Synchronization state

Returns one entry per synchronized resource. Today there is only listings. It is a safe technical view: it never contains tokens, credentials or raw marketplace responses. Use it to tell whether a Connection is up to date and when the next check happens.

A resource the marketplace neither notifies nor lets us enumerate has no entry. On Mercado Livre, listings has no entry until its listing read exists.

ModeCopy Anchor Link

• push: the marketplace notifies changes.
• poll: marketapi enumerates the resource periodically.
• hybrid: both. The mock adapter is hybrid.

Automatic reconciliationCopy Anchor Link

Every 6 hours, for each active Connection, marketapi enumerates the listings at the marketplace and updates observed on the ones that already exist locally, using the same rule as the inbound notification. The listing.external_changed event is emitted only when the observed state changed.

• A listing with no local record is not imported. It counts in unknownExternalCount. To bring it in, use import listings.
• If a pass fails, lastError holds a safe message and the next pass follows the normal schedule. If the marketplace says the seller's access has ended, the Connection is deactivated, as with any other call.
• With syncPolicy.inbound.mode = disabled, the listing does not change, and listing.external_changed is sent with behavior: observed_only on every pass while the marketplace differs from the stored observed. To store what is out there and stop the notice, import or reconcile.
• An import or reconciliation you requested that finishes sets lastFullSyncAt and pushes nextReconciliationAt back 6 hours.
• It is an internal job: it does not appear in /v1/jobs and emits no job.* events.

Connecting and reconnectingCopy Anchor Link

Connecting or reconnecting sets nextReconciliationAt to "now". The first pass recovers what changed while the Connection was revoked.

A notification that arrives while the Connection is inactive is not applied: its time is kept in deferredInboundAt. Compare it with lastFullSyncAt to see whether reconciliation has recovered it.

lastInboundAt is the last notification for the resource received while the Connection was active.

CaveatsCopy Anchor Link

• checkpoint is opaque and changes per marketplace. Do not parse it.
• To know whether a specific request succeeded, the record is the Job returned by import or reconcile. For an offer's state, read the Listing and its observed.