Folio Manager Configuration

SBXhttps://developers-sbx.gosocket.net/number-manager-admin

PRDhttps://developers.gosocket.net/number-manager-admin

Endpoints to configure the Folio Manager via API, replicating portal actions. Used in countries that require downloading folios from the tax authority: CL (SII) and CO. Under evaluation: CR, PY, UY.

Process overview

• All the APIs involved use the OAuth 2.0 authentication method.
• The refill threshold check, and consequently the execution of that refill if the threshold is reached, is performed every 2 hours, both for primary ranges and subranges.

AccessToken

POST /oauth2/token

Obtains the authentication token using an ApiKey key pair with OAuth 2.0. The token has a validity of 2 hours.

AccessToken

{
"grant_type": "client_credentials",
"client_id": "{{CLIENT_ID}}",
"client_secret": "{{CLIENT_SECRET}}"
}

---

Available endpoints

AddBillerPOSTCreates the billerId associated with the customer account.UpdateBillerPOSTUpdates an existing billerId.GetBillerByIdGETRetrieves information for a specific billerId.SaveBillerConfigurationPOSTDefines the refill sub-range size by document type.DeleteBillerConfigurationDELETERemoves the automatic sub-range refill configuration.SaveBillerThresholdPOSTDefines the automatic sub-range refill threshold.DeleteBillerThresholdDELETERemoves the refill threshold configuration.DownloadPrimaryRangeETPOSTDownloads folios from the SII for each document type.GetPrimaryRangeByFilterPOSTRetrieves primary ranges associated with a billerId.GetPrimaryRangeByIdGETRetrieves information for a specific primary range.GetBillerSubRangesGETRetrieves the sub-ranges associated with a billerId.SetGlobalFolioManagerAccountThresholdPOSTDefines refill and threshold for primary ranges at account level.GetGlobalFolioManagerAccountThresholdGETQueries the refill and threshold configuration at account level.DeleteGlobalFolioManagerAccountThresholdDELETERemoves the refill and threshold configuration at account level.AnnulmentPrimaryRangePOSTRetrieves the folios available for cancellation at the SII.ConfirmAnnulmentPrimaryRangePOSTConfirms the cancellation of a primary range at the SII.