PsaOnboardingCompanyStatus
This page contains
Fields
| status: PsaOnboardingRunStatus! PREVIEW | Whether the import ran to completion, not whether every company onboarded. Companies AppDirect or the PSA data will not accept (duplicate contact email, no contact, already bound) are an expected outcome and leave this COMPLETED with a non-zero failedCount; only a system failure reports FAILED. Read importedCount / failedCount / expectedCount for the outcome; userErrors lists system failures only, so a COMPLETED run with rejections reports none. |
| startedOn: DateTime | |
| completedOn: DateTime | |
| userErrors: [PsaOnboardingStatusError!]! PREVIEW | System-class import failures only, collapsed to one entry per distinct message and code. Per-company rejections are counted in failedCount and not listed here, so this is empty on a run where every failure was a rejection. Query company_import_records by executionId for the per-company detail. |
| companyImport: PsaOnboardingStepProgress! PREVIEW | |
| companyMapping: PsaOnboardingStepProgress! PREVIEW | Mapping completion from companyMapping documents for this execution's PSA company ids. |
| expectedCount: Int | PSA companies the worker listed for this execution. |
| importedCount: Int | Successful rows in company_import_records. |
| failedCount: Int | Failed rows in company_import_records. |
| mappedCount: Int | Distinct PSA companies present on companyMapping documents. |
Queries for PsaOnboardingCompanyStatus
| psaOnboardingStatus PREVIEW | Poll Magical Onboarding progress for a started execution. Reads feature collections (company_import_records, mappings, tax, product bind) plus Disti catalog progress when catalog sync has started. Collection query failures return COLLECTION_LOAD_FAILED rather than falling back to worker steps. |