intifact 1.5.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -58,6 +58,7 @@ console.log("Estado:", finalDoc.data.sunat.estado);
58
58
  - `listDocuments(query?)` — listado paginado con filtros
59
59
  - `getDocument(id)` — detalle completo
60
60
  - `getNextCorrelativo(query)` — siguiente correlativo de una serie
61
+ - `getSummary(id)` — estado de un envío RC/RA (el `id` que devuelven `sendSummary`, `sendVoided`, `cancelInvoice` y `cancelBoleta`)
61
62
  - `getTicketStatus(ticket, ruc)` — estado de ticket asíncrono
62
63
 
63
64
  ### Archivos (ArrayBuffer)
@@ -65,12 +66,6 @@ console.log("Estado:", finalDoc.data.sunat.estado);
65
66
  - `getNoteXml(id)` / `getNotePdf(id)`
66
67
  - `getDespatchXml(id)` / `getDespatchPdf(id, format?)` — `format`: a4 | ticket80 | ticket58
67
68
 
68
- ### Webhooks
69
- - `createWebhook(body)` / `listWebhooks()` / `getWebhook(id)`
70
- - `updateWebhook(id, body)` / `deleteWebhook(id)`
71
- - `listWebhookDeliveries(id)` / `redeliverWebhook(id, deliveryId)`
72
- - `testWebhook(id)` / `rotateWebhookSecret(id)`
73
-
74
69
  ### Catálogos SUNAT
75
70
  - `getCatalogs()` / `getCatalog(key)`
76
71
 
@@ -98,9 +93,31 @@ El código que va en `detalle[].codProdSunat`. SUNAT lo exige desde el
98
93
  ### Empresas (solo lectura)
99
94
  - `listCompanies()` / `getCompany(id)` / `getCompanyLogo(id)`
100
95
 
101
- > Crear empresas, subir certificado/logo, gestionar API keys, tenants, audit y
102
- > planes son operaciones administrativas (requieren `MASTER_API_KEY`) y no se
103
- > exponen en el SDK — las gestiona el backend (ERP).
96
+ ### Establecimientos (solo lectura)
97
+ El `codigo` (4 dígitos) va al XML como `cbc:AddressTypeCode` y decide qué
98
+ dirección sale impresa en el comprobante.
99
+ - `listBranches(companyId)` — para saber qué `establecimientoCodigo` mandar
100
+
101
+ > Alcance: una key con `tenantId` solo ve las empresas de su cuenta; con
102
+ > `companyId`, solo esa. Una empresa ajena responde **404**, no 403.
103
+
104
+ > La administración de la cuenta —crear o editar empresas, credenciales SOL/GRE,
105
+ > certificado, logo, registrar establecimientos y **webhooks**— se hace desde el
106
+ > panel de Intifact, no con la API key (la API responde `403`). Así una key
107
+ > filtrada solo puede emitir y consultar.
108
+
109
+ ## Migrar de 1.x a 2.0
110
+
111
+ La 2.0 quita los métodos que la API ya no acepta con una API key:
112
+
113
+ - Webhooks: `createWebhook`, `listWebhooks`, `getWebhook`, `updateWebhook`,
114
+ `deleteWebhook`, `listWebhookDeliveries`, `redeliverWebhook`, `testWebhook`,
115
+ `rotateWebhookSecret` y los tipos `CreateWebhookInput` / `UpdateWebhookInput`.
116
+ - Establecimientos: `createBranch`, `updateBranch`, `deactivateBranch` y los
117
+ tipos `CreateBranchInput` / `UpdateBranchInput` (`listBranches` se queda).
118
+
119
+ Todo eso se hace ahora desde el portal de Intifact. Del lado de tu código, los
120
+ webhooks solo se reciben y se verifica su firma con el secret que da el portal.
104
121
 
105
122
  ## Regenerar tipos
106
123