The /sync endpoints

Generating the endpoints

During code generation, APD adds these endpoints to every coverable, including the line itself (if it is a coverable).

Endpoint behavior

When you execute a POST /sync-coverages, Cloud API:

• Adds missing available-and-required coverages, conditions, and exclusions
• Removes unavailable coverages, conditions, and exclusions
• Adds missing covterms to coverages, conditions, and exclusions
• Removes unavailable covterms from coverages, conditions, and exclusions
• Resets the value if a covterm has an unavailable option, unavailable package, or unavailable or retired typekey as its current value. (The value is set to the default, or null if there is no default.)

Generating the endpoints

During code generation, APD adds these endpoints to every coverable (including the line itself) and every exposure that meet the following conditions:

• The coverable or exposure already exists in the data model and the corresponding data model entity implements the SyncableAdapter interface, or
• The coverable or exposure does not already exist in the data model. (This occurs when you are generating entities and endpoints at the same time for a new APD line).

If the data model entity for the coverable of exposure does not implement the SyncableAdapter interface, the /sync-fields endpoints are not generated. This can occur in the following circumstances:

• In some releases prior to the current release, Cloud API did not add the SyncableAdapter interface to new coverables and exposures. Thus, the code generation for those releases did not create /sync-fields endpoints. (Regenerating the LOB-specific endpoints on the current release will most likely generate the /sync-fields endpoints.)
• Lines of business that are not native to APD (such as base configuration LOBs or SBT lines) typically have coverables and exposures that do not implement the SyncableAdapter interface. Therefore, LOB-specific endpoints for these LOBs do not have /sync-fields endpoints.

Endpoint behavior

When you execute a POST /sync-fields, Cloud API:

• "Adds" missing available fields
• "Removes" unavailable fields
• Nulls out the value of any fields that have unavailable typekeys as their value

Generating the endpoints

During code generation, APD adds these endpoints to every coverable that meets one of the following conditions:

• The coverable is already declared in the data model and the data model entity implements the Modifiable interface, or
• The coverable is part of a product that was originally designed outside of APD (such as a base configuration product or a product from a Standards-Based Template).

These endpoints are added for installed products only. They are not present for visualized products.

Endpoint behavior

When you execute a POST /sync-modifiers, Cloud API:

• Adds missing available modifiers
• Removes unavailable modifiers
• Updates the state on modifiers to make sure it matches the state of the parent entity
• Adds missing available rate factors to modifiers
• Removes unavailable rate factors from modifiers

Generating the endpoints

In the base configuration, these endpoints already exist for the job itself and for policy locations.

During code generation, APD adds endpoints to:

• Every location-based coverable
  • This type of endpoint is essentially proxy for calling /sync-questions on the linked policy location.
• Every policy line, because the base configuration PolicyLine entity implements the AnswerContainer interface
• Any other coverables or exposures that are already declared in the data model and the data model entity implements the AnswerContainer interface

These endpoints are added for installed products only. They are not present for visualized products.

Endpoint behavior

When you execute a POST /sync-questions, Cloud API:

• Adds answer entities to hold the answer for any missing available questions
• Removes answers for any unavailable questions