lorentz/wulf-pulse
1
0
Fork 0
Code Issues 1 Pull requests Projects Releases Packages Wiki Activity Actions

docs: update SYNC_BEHAVIOR.md with Companies and Resources limitations

Browse source 
Document that Companies and Resources entities do not support
incremental sync in the Autotask API and automatically fall back
to full sync when incremental sync is requested.

This clarifies expected behavior and prevents confusion about why
these entities always perform full syncs even during incremental
sync operations.
This commit is contained in:
root 2026-01-26 12:26:57 -05:00
parent fc284aba85
commit a1e50a7161
1 changed files with 15 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

18
docs/SYNC_BEHAVIOR.md
View file

@ -66,13 +66,25 @@ Full Sync of Tickets (last 2 years):
- Requires a previous successful sync to establish baseline
- Falls back to full sync if no previous sync found
**Important Limitations:**
- **Companies and Resources** do NOT support incremental sync
- These entities automatically fall back to full sync
- Autotask API does not support date-based filtering for these entities
- This is by design and prevents sync failures
**Example:**
```
Incremental Sync of Companies:
Incremental Sync of Tickets:
1. Get last sync time: 2026-01-24 08:00:00
2. Fetch companies where lastModifiedDate >= 2026-01-24 08:00:00
3. Upsert only the changed companies
2. Fetch tickets where lastActivityDate >= 2026-01-24 08:00:00
3. Upsert only the changed tickets
4. No soft deletes
Incremental Sync of Companies (automatic fallback):
1. Request incremental sync
2. System detects Companies doesn't support incremental
3. Automatically performs full sync instead
4. Logs: "companies does not support incremental sync, performing full sync instead"
```
### Sync Selected (Entity-Specific)