SIGN IT - Can I update the Taxpayer data?

address and fiscalization

A Taxpayer's address and fiscalization (incl. credentials) can be updated as long as the resource is in the ACQUIRED state, or in the COMMISSIONED state with mode SUSPENDED. 

• If your Taxpayer is in state ACQUIRED state, simply call updateTaxpayer with the updated data
• If your Taxpayer is in state COMMISSIONED, first suspend the resource (mode: "SUSPENDED"), make the update, then re-activate it (mode: "OPERATIVE"). 

For details on updating credentials specifically, see this article: SIGN IT - How to update the FISCONLINE credentials

type and name

Unlike other fields, a Taxpayer's type and name can only be modified while the resource is in the ACQUIRED state. Once the state changes to COMMISSIONED, these fields can no longer be updated. 

In that case, you can proceed as follows:

1. Create a new Taxpayer under the same Organization UNIT. The resource will be in the ACQUIRED state by default.
    
2. If you have existing Locations assigned to the old Taxpayer: 
   • If they're in state COMMISSIONED, update them to mode SUSPENDED via updateLocation
   • If they're in state ACQUIRED, skip directly to step 3
      
3. Assign the existing Locations (if any) to the new Taxpayer ID via updateLocation. 

{
    "content": {
        "taxpayer": {
            "id": "{{taxpayerId}}"
        }
    }
}

4. Update the old Taxpayer from state COMMISSIONED to DECOMMISSIONED via updateTaxpayer.
    
5. Update the new Taxpayer from state ACQUIRED to COMMISSIONED via updateTaxpayer. 
    
6. Update the existing Locations (if any) to mode OPERATIVE:
   • If they were suspended in step 2, set them back to mode OPERATIVE via updateLocation
   • If they're still in state ACQUIRED, simply update them to state COMMISSIONED whenever you're ready.

Metadata

A Taxpayer's metadata remains fully updatable, regardless of the resource's state and mode.