Saltar al contenido principal

Folio Manager Configuration

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

Endpoints para configurar el Folio Manager vía API, replicando las acciones del portal. Se usa en países que requieren descarga de folios desde la entidad tributaria: CL (SII) y CO. En evaluación: CR, PY, UY.

Generalidades del proceso​

  • Para todas las APIs involucradas se utiliza el método de autenticación OAuth 2.0.
  • La verificación de los umbrales de recarga, y en consecuencia la ejecución de dicha recarga si se alcanza el umbral, se realiza cada 2 horas, tanto para los rangos primarios como para los subrangos.

AccessToken​

POST /oauth2/token

Obtiene el token de autenticación usando un par de claves ApiKey con OAuth 2.0. El token tiene una vigencia de 2 horas.

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

Endpoints disponibles​

AddBillerPOSTCrea el billerId asociado a la cuenta del cliente.UpdateBillerPOSTActualiza un billerId existente.GetBillerByIdGETObtiene información de un billerId específico.SaveBillerConfigurationPOSTDefine el tamaño de los subrangos de recarga por tipo de documento.DeleteBillerConfigurationDELETEElimina la configuración de recarga automática de subrangos.SaveBillerThresholdPOSTDefine el umbral de recarga automática de subrangos.DeleteBillerThresholdDELETEElimina la configuración del umbral de recarga.DownloadPrimaryRangeETPOSTDescarga folios desde el SII para cada tipo de documento.GetPrimaryRangeByFilterPOSTObtiene rangos primarios asociados a un billerId.GetPrimaryRangeByIdGETObtiene información de un rango primario específico.GetBillerSubRangesGETObtiene los subrangos asociados a un billerId.SetGlobalFolioManagerAccountThresholdPOSTDefine refill y threshold de rangos primarios a nivel de cuenta.GetGlobalFolioManagerAccountThresholdGETConsulta la configuración de refill y threshold a nivel de cuenta.DeleteGlobalFolioManagerAccountThresholdDELETEElimina la configuración de recarga y umbral a nivel de cuenta.AnnulmentPrimaryRangePOSTObtiene los folios disponibles para anulación ante el SII.ConfirmAnnulmentPrimaryRangePOSTConfirma la anulación de un rango primario ante el SII.