fiscalisto 0.1.53 → 0.1.54

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/dist/core.d.ts CHANGED
@@ -4,7 +4,7 @@
4
4
  * llamar.
5
5
  */
6
6
  import type { ErrorCode } from "./error-codes.js";
7
- export declare const VERSION = "0.1.53";
7
+ export declare const VERSION = "0.1.54";
8
8
  /**
9
9
  * La versión de la API para la que se hizo este SDK: la manda en cada solicitud
10
10
  * (Fiscalisto-Version), así actualizar la API no cambia lo que recibe hasta que actualice el SDK.
package/dist/core.js CHANGED
@@ -3,7 +3,7 @@
3
3
  * errores y las listas que se recorren solas. Los recursos (generated.ts) solo dicen qué ruta
4
4
  * llamar.
5
5
  */
6
- export const VERSION = "0.1.53";
6
+ export const VERSION = "0.1.54";
7
7
  /**
8
8
  * La versión de la API para la que se hizo este SDK: la manda en cada solicitud
9
9
  * (Fiscalisto-Version), así actualizar la API no cambia lo que recibe hasta que actualice el SDK.
@@ -61,6 +61,14 @@ export declare const ErrorCode: {
61
61
  readonly ExpandInvalid: "expand_invalid";
62
62
  /** Viáticos y gastos no lo permite en ese momento: el mensaje dice por qué (un gasto con errores al enviarla, un reembolso antes de aprobarla, aprobar lo que usted mismo envió). */
63
63
  readonly ExpenseReportInvalid: "expense_report_invalid";
64
+ /** Ninguna factura del emisor coincide con el periodo y los filtros de POST /v1/exports: no se generó nada. */
65
+ readonly ExportEmpty: "export_empty";
66
+ /** Los archivos de una exportación se guardan 30 días. Pídala otra vez con POST /v1/exports. */
67
+ readonly ExportExpired: "export_expired";
68
+ /** Ya hay una exportación del mismo formato generándose en la empresa. Espere a que termine (GET /v1/exports) y pida la siguiente. */
69
+ readonly ExportInProgress: "export_in_progress";
70
+ /** La exportación aún se genera (status processing) o falló (failed). Consulte GET /v1/exports/{id}; si falló, pídala otra vez. */
71
+ readonly ExportNotReady: "export_not_ready";
64
72
  /** En producción, inventario avanzado, portal de proveedores, pedidos de venta y comprobación de gastos siguen el plan de la empresa, como en la app: vienen con Operaciones (se agrega a Negocio; incluida en Corporativo). En modo de pruebas están todos. */
65
73
  readonly FeatureNotInPlan: "feature_not_in_plan";
66
74
  /** Idempotency-Key es de 1 a 255 caracteres ASCII, sin acentos ni ñ: el id de su pedido o un UUID. */
@@ -69,7 +77,7 @@ export declare const ErrorCode: {
69
77
  readonly IdempotencyKeyMissing: "idempotency_key_missing";
70
78
  /** Esa Idempotency-Key ya se usó en las últimas 24 horas con otra solicitud (otra ruta u otro cuerpo). Use una nueva para cada operación distinta. */
71
79
  readonly IdempotencyKeyReused: "idempotency_key_reused";
72
- /** La cuenta no tiene timbres de producción: para timbrar, revisar RFC en las listas, consultar constancias, pedir descargas o traer declaraciones, opinión o buzón del SAT. Compre un paquete en Desarrolladores › Timbres. En pruebas nunca pasa. Para enterarse antes, escuche balance.low o active la recarga automática. */
80
+ /** La cuenta no tiene timbres de producción: para timbrar, revisar RFC en las listas, consultar constancias, pedir descargas o traer declaraciones, opinión o buzón del SAT. Compre un paquete en Desarrolladores › Timbres y pagos. En pruebas nunca pasa. Para enterarse antes, escuche balance.low o active la recarga automática. */
73
81
  readonly InsufficientBalance: "insufficient_balance";
74
82
  /** Algo falló de nuestro lado. Repita la solicitud con la misma Idempotency-Key: nunca se timbra dos veces. Si sigue, escríbanos con el request_id. */
75
83
  readonly InternalError: "internal_error";
@@ -97,6 +105,8 @@ export declare const ErrorCode: {
97
105
  readonly IssuerCreationLimit: "issuer_creation_limit";
98
106
  /** Ese RFC ya es un emisor de la cuenta en este modo. */
99
107
  readonly IssuerExists: "issuer_exists";
108
+ /** El emisor no tiene equipo: el equipo es el de una empresa, en sus emisores propios (type own) y con una llave fk_live_. Un emisor conectado o uno de pruebas no tiene miembros. */
109
+ readonly IssuerHasNoTeam: "issuer_has_no_team";
100
110
  /** El emisor es una empresa de la app conectada a la cuenta (source empresa): con la API solo se usa su Portal de proveedores. */
101
111
  readonly IssuerLinkedEmpresa: "issuer_linked_empresa";
102
112
  /** No existe ese emisor en la cuenta (o es del otro modo). */
@@ -207,6 +217,14 @@ export declare const ErrorCode: {
207
217
  readonly SubstitutionUnsupported: "substitution_unsupported";
208
218
  /** La factura del proveedor no admite eso en su estado (por ejemplo, programar una que no está aprobada, una fecha de pago pasada o marcar pagada una ya pagada), o el SAT la reporta cancelada. El mensaje dice por qué. */
209
219
  readonly SupplierInvoiceInvalid: "supplier_invoice_invalid";
220
+ /** El cambio da, quita o toca un permiso delicado (equipo, credenciales, seguridad o plan), o nombra a un propietario: pide confirmar la identidad de quien lo hace, y eso se hace en la app, en Ajustes › Miembros o Ajustes › Roles. */
221
+ readonly TeamChangeRequiresApp: "team_change_requires_app";
222
+ /** El cambio no se puede: la persona ya es miembro, quedaría la empresa sin propietario, ya hay un rol con ese nombre, el rol lo tiene alguien, o se mandaron demasiadas invitaciones hoy. El mensaje dice cuál. */
223
+ readonly TeamInvalid: "team_invalid";
224
+ /** La llave actúa como la persona que la creó, con su acceso en la empresa: le falta el permiso para esto, o lo que pide daría más de lo que ella tiene, o ya no es miembro. */
225
+ readonly TeamPermissionDenied: "team_permission_denied";
226
+ /** El plan de la empresa ya tiene todos sus usuarios (miembros más invitaciones pendientes). Cambie de plan en Ajustes › Plan y pagos o quite a alguien. */
227
+ readonly TeamSeatLimit: "team_seat_limit";
210
228
  /** El reloj se está adelantando en otra solicitud (409, con Retry-After). Espere a test_clock.ready y repita. */
211
229
  readonly TestClockAdvancing: "test_clock_advancing";
212
230
  /** El emisor ya tiene un reloj de prueba: adelántelo, o bórrelo para volver a la hora real. */
@@ -62,6 +62,14 @@ export const ErrorCode = {
62
62
  ExpandInvalid: "expand_invalid",
63
63
  /** Viáticos y gastos no lo permite en ese momento: el mensaje dice por qué (un gasto con errores al enviarla, un reembolso antes de aprobarla, aprobar lo que usted mismo envió). */
64
64
  ExpenseReportInvalid: "expense_report_invalid",
65
+ /** Ninguna factura del emisor coincide con el periodo y los filtros de POST /v1/exports: no se generó nada. */
66
+ ExportEmpty: "export_empty",
67
+ /** Los archivos de una exportación se guardan 30 días. Pídala otra vez con POST /v1/exports. */
68
+ ExportExpired: "export_expired",
69
+ /** Ya hay una exportación del mismo formato generándose en la empresa. Espere a que termine (GET /v1/exports) y pida la siguiente. */
70
+ ExportInProgress: "export_in_progress",
71
+ /** La exportación aún se genera (status processing) o falló (failed). Consulte GET /v1/exports/{id}; si falló, pídala otra vez. */
72
+ ExportNotReady: "export_not_ready",
65
73
  /** En producción, inventario avanzado, portal de proveedores, pedidos de venta y comprobación de gastos siguen el plan de la empresa, como en la app: vienen con Operaciones (se agrega a Negocio; incluida en Corporativo). En modo de pruebas están todos. */
66
74
  FeatureNotInPlan: "feature_not_in_plan",
67
75
  /** Idempotency-Key es de 1 a 255 caracteres ASCII, sin acentos ni ñ: el id de su pedido o un UUID. */
@@ -70,7 +78,7 @@ export const ErrorCode = {
70
78
  IdempotencyKeyMissing: "idempotency_key_missing",
71
79
  /** Esa Idempotency-Key ya se usó en las últimas 24 horas con otra solicitud (otra ruta u otro cuerpo). Use una nueva para cada operación distinta. */
72
80
  IdempotencyKeyReused: "idempotency_key_reused",
73
- /** La cuenta no tiene timbres de producción: para timbrar, revisar RFC en las listas, consultar constancias, pedir descargas o traer declaraciones, opinión o buzón del SAT. Compre un paquete en Desarrolladores › Timbres. En pruebas nunca pasa. Para enterarse antes, escuche balance.low o active la recarga automática. */
81
+ /** La cuenta no tiene timbres de producción: para timbrar, revisar RFC en las listas, consultar constancias, pedir descargas o traer declaraciones, opinión o buzón del SAT. Compre un paquete en Desarrolladores › Timbres y pagos. En pruebas nunca pasa. Para enterarse antes, escuche balance.low o active la recarga automática. */
74
82
  InsufficientBalance: "insufficient_balance",
75
83
  /** Algo falló de nuestro lado. Repita la solicitud con la misma Idempotency-Key: nunca se timbra dos veces. Si sigue, escríbanos con el request_id. */
76
84
  InternalError: "internal_error",
@@ -98,6 +106,8 @@ export const ErrorCode = {
98
106
  IssuerCreationLimit: "issuer_creation_limit",
99
107
  /** Ese RFC ya es un emisor de la cuenta en este modo. */
100
108
  IssuerExists: "issuer_exists",
109
+ /** El emisor no tiene equipo: el equipo es el de una empresa, en sus emisores propios (type own) y con una llave fk_live_. Un emisor conectado o uno de pruebas no tiene miembros. */
110
+ IssuerHasNoTeam: "issuer_has_no_team",
101
111
  /** El emisor es una empresa de la app conectada a la cuenta (source empresa): con la API solo se usa su Portal de proveedores. */
102
112
  IssuerLinkedEmpresa: "issuer_linked_empresa",
103
113
  /** No existe ese emisor en la cuenta (o es del otro modo). */
@@ -208,6 +218,14 @@ export const ErrorCode = {
208
218
  SubstitutionUnsupported: "substitution_unsupported",
209
219
  /** La factura del proveedor no admite eso en su estado (por ejemplo, programar una que no está aprobada, una fecha de pago pasada o marcar pagada una ya pagada), o el SAT la reporta cancelada. El mensaje dice por qué. */
210
220
  SupplierInvoiceInvalid: "supplier_invoice_invalid",
221
+ /** El cambio da, quita o toca un permiso delicado (equipo, credenciales, seguridad o plan), o nombra a un propietario: pide confirmar la identidad de quien lo hace, y eso se hace en la app, en Ajustes › Miembros o Ajustes › Roles. */
222
+ TeamChangeRequiresApp: "team_change_requires_app",
223
+ /** El cambio no se puede: la persona ya es miembro, quedaría la empresa sin propietario, ya hay un rol con ese nombre, el rol lo tiene alguien, o se mandaron demasiadas invitaciones hoy. El mensaje dice cuál. */
224
+ TeamInvalid: "team_invalid",
225
+ /** La llave actúa como la persona que la creó, con su acceso en la empresa: le falta el permiso para esto, o lo que pide daría más de lo que ella tiene, o ya no es miembro. */
226
+ TeamPermissionDenied: "team_permission_denied",
227
+ /** El plan de la empresa ya tiene todos sus usuarios (miembros más invitaciones pendientes). Cambie de plan en Ajustes › Plan y pagos o quite a alguien. */
228
+ TeamSeatLimit: "team_seat_limit",
211
229
  /** El reloj se está adelantando en otra solicitud (409, con Retry-After). Espere a test_clock.ready y repita. */
212
230
  TestClockAdvancing: "test_clock_advancing",
213
231
  /** El emisor ya tiene un reloj de prueba: adelántelo, o bórrelo para volver a la hora real. */
@@ -39,7 +39,7 @@ export interface Balance {
39
39
  available: number;
40
40
  /** true si la cuenta timbra sin usar timbres. */
41
41
  unlimited: boolean;
42
- /** Con esta cantidad o menos llega balance.low (y otra vez al acabarse). Se elige en Desarrolladores › Timbres. */
42
+ /** Con esta cantidad o menos llega balance.low (y otra vez al acabarse). Se elige en Desarrolladores › Timbres y pagos. */
43
43
  low_balance_at: number;
44
44
  /** La recarga automática con la tarjeta guardada, o null si está apagada. */
45
45
  auto_recharge: {
@@ -50,7 +50,7 @@ export interface Balance {
50
50
  /** Como máximo tantas compras al mes. */
51
51
  max_per_month: number;
52
52
  } | null;
53
- /** true si, al acabarse `available`, la API sigue timbrando con los timbres del plan de la empresa (Desarrolladores › Timbres › Si se acaban, usar los timbres de la empresa). false: responde 402 insufficient_balance. */
53
+ /** true si, al acabarse `available`, la API sigue timbrando con los timbres del plan de la empresa (Desarrolladores › Timbres y pagos › Si se acaban, usar los timbres de la empresa). false: responde 402 insufficient_balance. */
54
54
  use_plan_timbres: boolean;
55
55
  /** Los paquetes con timbres, el que vence antes primero (en ese orden se usan). */
56
56
  packs: {
@@ -1134,6 +1134,143 @@ export interface InvoicePreview {
1134
1134
  /** El XML que se mandaría al PAC, sin sello ni timbre. */
1135
1135
  unsigned_xml: string;
1136
1136
  }
1137
+ /** Las facturas de un emisor en un periodo, en un ZIP o en Excel. */
1138
+ export interface Export {
1139
+ /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
1140
+ id: string;
1141
+ /** Qué tipo de objeto es («invoice», «customer»…). */
1142
+ object: "export";
1143
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
1144
+ livemode: boolean;
1145
+ /** El emisor (iss_…). */
1146
+ issuer: string;
1147
+ /** zip (los archivos de cada factura) o xlsx (un Excel con una fila por factura). */
1148
+ format: "zip" | "xlsx";
1149
+ /** Qué archivos de cada factura lleva el ZIP; null en un Excel. */
1150
+ files: "xml" | "pdf" | "xml_and_pdf" | null;
1151
+ /** EntradaSalidaMerc: Entrada o Salida. */
1152
+ direction: "issued" | "received";
1153
+ /** Desde qué día (incluido), por la fecha de emisión. */
1154
+ from: string | null;
1155
+ /** Hasta qué día (incluido), por la fecha de emisión. */
1156
+ to: string | null;
1157
+ /** Tipo de comprobante (TipoDeComprobante): I ingreso, E egreso, P pago, T traslado, N nómina. */
1158
+ type: "I" | "E" | "P" | "T" | "N" | null;
1159
+ /** processing: se está generando. completed: listo para descargar. failed: falló (ver error); pídala otra vez. expired: pasaron 30 días y el archivo se borró. */
1160
+ status: "processing" | "completed" | "failed" | "expired";
1161
+ /** Cuántas facturas lleva. */
1162
+ invoice_count: number;
1163
+ /** El tamaño del archivo en bytes, cuando está listo. */
1164
+ size_bytes: number | null;
1165
+ /** Por qué falló la exportación, en palabras; null si no falló. */
1166
+ error: string | null;
1167
+ /** Cuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00). */
1168
+ created_at: string | null;
1169
+ /** Cuándo terminó. */
1170
+ completed_at: string | null;
1171
+ /** Hasta cuándo se descarga (30 días después de completed). */
1172
+ expires_at: string | null;
1173
+ }
1174
+ /** Una persona que entra a la empresa en la app. */
1175
+ export interface Member {
1176
+ /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
1177
+ id: string;
1178
+ /** Qué tipo de objeto es («invoice», «customer»…). */
1179
+ object: "member";
1180
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
1181
+ livemode: boolean;
1182
+ /** El emisor (iss_…). */
1183
+ issuer: string;
1184
+ /** Nombre. */
1185
+ name: string | null;
1186
+ /** Correo a donde se envía (varios separados por comas). Solo se usa si se pide enviarlo. */
1187
+ email: string;
1188
+ /** El rol (id de GET /v1/roles). */
1189
+ role: string;
1190
+ /** true: todos los permisos, incluidos los que se agreguen después. */
1191
+ all_permissions: boolean;
1192
+ /** Permisos además de los del rol. */
1193
+ permissions_added: string[];
1194
+ /** Permisos del rol que esta persona no tiene. */
1195
+ permissions_removed: string[];
1196
+ /** Solo trabaja con estos RFC de la empresa; null: con todos. */
1197
+ tax_ids: string[] | null;
1198
+ /** Solo emite desde estas sucursales (brn_…, o "matriz"); null: desde todas. */
1199
+ branches: string[] | null;
1200
+ /** Lo que puede hacer al final: los permisos del rol, más los agregados, menos los quitados. */
1201
+ permissions: string[];
1202
+ /** Si entra con verificación en dos pasos. */
1203
+ two_factor_enabled: boolean;
1204
+ /** Cuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00). */
1205
+ created_at: string;
1206
+ }
1207
+ /** Una invitación a la empresa que aún no se acepta. */
1208
+ export interface Invitation {
1209
+ /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
1210
+ id: string;
1211
+ /** Qué tipo de objeto es («invoice», «customer»…). */
1212
+ object: "invitation";
1213
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
1214
+ livemode: boolean;
1215
+ /** El emisor (iss_…). */
1216
+ issuer: string;
1217
+ /** Correo a donde se envía (varios separados por comas). Solo se usa si se pide enviarlo. */
1218
+ email: string;
1219
+ /** El rol (id de GET /v1/roles). */
1220
+ role: string;
1221
+ /** true: todos los permisos, incluidos los que se agreguen después. */
1222
+ all_permissions: boolean;
1223
+ /** Permisos además de los del rol. */
1224
+ permissions_added: string[];
1225
+ /** Permisos del rol que esta persona no tiene. */
1226
+ permissions_removed: string[];
1227
+ /** Solo trabaja con estos RFC de la empresa; null: con todos. */
1228
+ tax_ids: string[] | null;
1229
+ /** Solo emite desde estas sucursales (brn_…, o "matriz"); null: desde todas. */
1230
+ branches: string[] | null;
1231
+ /** pending: su enlace sirve. canceled: se canceló. */
1232
+ status: "pending" | "canceled";
1233
+ /** Hasta cuándo sirve su enlace (7 días). */
1234
+ expires_at: string;
1235
+ }
1236
+ /** Un rol de la empresa: un nombre y sus permisos. */
1237
+ export interface Role {
1238
+ /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
1239
+ id: string;
1240
+ /** Qué tipo de objeto es («invoice», «customer»…). */
1241
+ object: "role";
1242
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
1243
+ livemode: boolean;
1244
+ /** El emisor (iss_…). */
1245
+ issuer: string;
1246
+ /** Nombre. */
1247
+ name: string;
1248
+ /** Descripción. */
1249
+ description: string | null;
1250
+ /** true: el rol tiene todos los permisos, incluidos los futuros. */
1251
+ all_permissions: boolean;
1252
+ /** Sus permisos (vacío con all_permissions). */
1253
+ permissions: string[];
1254
+ /** owner: Propietario. starter: uno de los de Fiscalisto (se puede cambiar, no borrar). custom: uno de la empresa. */
1255
+ type: "owner" | "starter" | "custom";
1256
+ /** Cuántos miembros lo tienen. */
1257
+ members: number;
1258
+ /** Cuántas invitaciones pendientes lo dan. */
1259
+ invitations: number;
1260
+ }
1261
+ /** Algo que una persona puede hacer en la empresa. */
1262
+ export interface Permission {
1263
+ /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
1264
+ id: string;
1265
+ /** Qué tipo de objeto es («invoice», «customer»…). */
1266
+ object: "permission";
1267
+ /** Nombre. */
1268
+ name: string;
1269
+ /** Su grupo, como en Ajustes › Roles. */
1270
+ group: string;
1271
+ /** Delicado (equipo, credenciales, seguridad, plan): darlo o quitarlo se hace en la app. */
1272
+ sensitive: boolean;
1273
+ }
1137
1274
  /** Un anticipo timbrado que aún no se aplica. */
1138
1275
  export interface Advance {
1139
1276
  /** Qué tipo de objeto es («invoice», «customer»…). */
@@ -4612,6 +4749,56 @@ export interface SatListCheckList {
4612
4749
  /** La ruta de esta lista. */
4613
4750
  url: string;
4614
4751
  }
4752
+ export interface MemberList {
4753
+ /** Qué tipo de objeto es («invoice», «customer»…). */
4754
+ object: "list";
4755
+ /** Los objetos de esta página. */
4756
+ data: Member[];
4757
+ /** true si hay más: pida la siguiente con starting_after igual al id del último. */
4758
+ has_more: boolean;
4759
+ /** La ruta de esta lista. */
4760
+ url: string;
4761
+ }
4762
+ export interface InvitationList {
4763
+ /** Qué tipo de objeto es («invoice», «customer»…). */
4764
+ object: "list";
4765
+ /** Los objetos de esta página. */
4766
+ data: Invitation[];
4767
+ /** true si hay más: pida la siguiente con starting_after igual al id del último. */
4768
+ has_more: boolean;
4769
+ /** La ruta de esta lista. */
4770
+ url: string;
4771
+ }
4772
+ export interface RoleList {
4773
+ /** Qué tipo de objeto es («invoice», «customer»…). */
4774
+ object: "list";
4775
+ /** Los objetos de esta página. */
4776
+ data: Role[];
4777
+ /** true si hay más: pida la siguiente con starting_after igual al id del último. */
4778
+ has_more: boolean;
4779
+ /** La ruta de esta lista. */
4780
+ url: string;
4781
+ }
4782
+ export interface PermissionList {
4783
+ /** Qué tipo de objeto es («invoice», «customer»…). */
4784
+ object: "list";
4785
+ /** Los objetos de esta página. */
4786
+ data: Permission[];
4787
+ /** true si hay más: pida la siguiente con starting_after igual al id del último. */
4788
+ has_more: boolean;
4789
+ /** La ruta de esta lista. */
4790
+ url: string;
4791
+ }
4792
+ export interface ExportList {
4793
+ /** Qué tipo de objeto es («invoice», «customer»…). */
4794
+ object: "list";
4795
+ /** Los objetos de esta página. */
4796
+ data: Export[];
4797
+ /** true si hay más: pida la siguiente con starting_after igual al id del último. */
4798
+ has_more: boolean;
4799
+ /** La ruta de esta lista. */
4800
+ url: string;
4801
+ }
4615
4802
  export interface SatDownloadList {
4616
4803
  /** Qué tipo de objeto es («invoice», «customer»…). */
4617
4804
  object: "list";
@@ -5583,6 +5770,8 @@ export interface InvoiceCreate {
5583
5770
  email_cc?: string | null;
5584
5771
  /** Sus propios datos: hasta 50 llaves de 40 caracteres con valores de texto de hasta 500. No van al CFDI; vuelven en el objeto y en los webhooks. */
5585
5772
  metadata?: Record<string, string>;
5773
+ /** Solo en POST /v1/invoices. true: responde 202 en cuanto la factura queda guardada con su folio (status processing) y la timbra después de responder; invoice.stamped o invoice.failed dicen cómo terminó. En las demás rutas que reciben una factura no cambia nada. */
5774
+ async?: boolean;
5586
5775
  }
5587
5776
  /** Un recibo de nómina que calculó su sistema, con todos sus conceptos e importes: se timbra tal cual. */
5588
5777
  export interface ExternalPayrollReceiptCreate {
@@ -7704,6 +7893,109 @@ export interface VerifyCfdiParams {
7704
7893
  /** El total del comprobante, sin XML ni QR. El SAT lo compara como número. */
7705
7894
  total?: number;
7706
7895
  }
7896
+ /** Los parámetros de GET /v1/members. */
7897
+ export interface ListMembersParams {
7898
+ /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
7899
+ issuer?: string;
7900
+ }
7901
+ export interface UpdateMemberParams {
7902
+ /** El rol (id de GET /v1/roles, como admin, contador, facturista o uno suyo). owner es Propietario: solo un propietario da o quita ese rol. */
7903
+ role?: string;
7904
+ /** true: todos los permisos, incluidos los que se agreguen después (además de los del rol). */
7905
+ all_permissions?: boolean;
7906
+ /** Permisos además de los del rol (GET /v1/permissions). */
7907
+ permissions_added?: string[];
7908
+ /** Permisos del rol que esta persona no tiene. */
7909
+ permissions_removed?: string[];
7910
+ /** Solo trabaja con estos RFC de la empresa. null: con todos. */
7911
+ tax_ids?: string[] | null;
7912
+ /** Solo emite desde estas sucursales (brn_…, o "matriz" para el domicilio fiscal). null: desde todas. */
7913
+ branches?: string[] | null;
7914
+ }
7915
+ /** Los parámetros de GET /v1/invitations. */
7916
+ export interface ListInvitationsParams {
7917
+ /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
7918
+ issuer?: string;
7919
+ }
7920
+ export interface CreateInvitationParams {
7921
+ /** El emisor (iss_…) de la empresa. Por omisión, su único emisor. */
7922
+ issuer?: string;
7923
+ /** El correo de la persona: le llega la invitación, válida 7 días. */
7924
+ email: string;
7925
+ /** El rol (id de GET /v1/roles, como admin, contador, facturista o uno suyo). owner es Propietario: solo un propietario da o quita ese rol. */
7926
+ role: string;
7927
+ /** true: todos los permisos, incluidos los que se agreguen después (además de los del rol). */
7928
+ all_permissions?: boolean;
7929
+ /** Permisos además de los del rol (GET /v1/permissions). */
7930
+ permissions_added?: string[];
7931
+ /** Permisos del rol que esta persona no tiene. */
7932
+ permissions_removed?: string[];
7933
+ /** Solo trabaja con estos RFC de la empresa. null: con todos. */
7934
+ tax_ids?: string[] | null;
7935
+ /** Solo emite desde estas sucursales (brn_…, o "matriz" para el domicilio fiscal). null: desde todas. */
7936
+ branches?: string[] | null;
7937
+ }
7938
+ /** Los parámetros de GET /v1/roles. */
7939
+ export interface ListRolesParams {
7940
+ /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
7941
+ issuer?: string;
7942
+ }
7943
+ export interface CreateRoleParams {
7944
+ /** El emisor (iss_…) de la empresa. Por omisión, su único emisor. */
7945
+ issuer?: string;
7946
+ /** Como se ve en la app. */
7947
+ name: string;
7948
+ /** Descripción. */
7949
+ description?: string | null;
7950
+ /** true: todos los permisos, incluidos los que se agreguen después. */
7951
+ all_permissions?: boolean;
7952
+ /** Sus permisos (GET /v1/permissions). Los que otro necesita se agregan solos (timbrar pide ver facturas). */
7953
+ permissions?: string[];
7954
+ }
7955
+ export interface UpdateRoleParams {
7956
+ /** El emisor (iss_…) de la empresa. Por omisión, su único emisor. */
7957
+ issuer?: string;
7958
+ /** Descripción. */
7959
+ description?: string | null;
7960
+ /** true: todos los permisos, incluidos los que se agreguen después. */
7961
+ all_permissions?: boolean;
7962
+ /** Sus permisos (GET /v1/permissions). Los que otro necesita se agregan solos (timbrar pide ver facturas). */
7963
+ permissions?: string[];
7964
+ /** Como se ve en la app. */
7965
+ name?: string;
7966
+ }
7967
+ /** Los parámetros de DELETE /v1/roles/{id}. */
7968
+ export interface DeleteRoleParams {
7969
+ /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
7970
+ issuer?: string;
7971
+ }
7972
+ export interface CreateExportParams {
7973
+ /** El emisor (iss_…). Por omisión, su único emisor. */
7974
+ issuer?: string;
7975
+ /** Un mes completo (AAAA-MM), por la fecha de emisión en hora de la Ciudad de México. Mande month, o from y to. */
7976
+ month?: string;
7977
+ /** Desde qué día (incluido), en lugar de month. */
7978
+ from?: string;
7979
+ /** Hasta qué día (incluido), en lugar de month. A lo más 7 ejercicios. */
7980
+ to?: string;
7981
+ /** issued (las facturas que emitió el emisor, por omisión) o received (las que le hicieron). */
7982
+ direction?: "issued" | "received";
7983
+ /** Solo un tipo de comprobante: I, E, P, T o N. Por omisión, todos. */
7984
+ type?: "I" | "E" | "P" | "T" | "N";
7985
+ /** zip (los archivos de cada factura, por omisión) o xlsx (un Excel con una fila por factura). */
7986
+ format?: "zip" | "xlsx";
7987
+ /** Con format zip: xml (por omisión), pdf, o xml_and_pdf (los dos de cada factura). */
7988
+ files?: "xml" | "pdf" | "xml_and_pdf";
7989
+ }
7990
+ /** Los parámetros de GET /v1/exports. */
7991
+ export interface ListExportsParams {
7992
+ /** Cuántos por página, de 1 a 100. Por omisión 10. */
7993
+ limit?: number;
7994
+ /** El id del último de la página anterior, para la siguiente. */
7995
+ starting_after?: string;
7996
+ /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
7997
+ issuer?: string;
7998
+ }
7707
7999
  export interface CreateSatDownloadParams {
7708
8000
  /** El emisor (iss_…). Por omisión, su único emisor. */
7709
8001
  issuer?: string;
@@ -9252,7 +9544,7 @@ export declare class InvoicesResource {
9252
9544
  /**
9253
9545
  * Timbrar una factura
9254
9546
  *
9255
- * Revisa la factura con las reglas del SAT, la sella y la timbra en una sola llamada. Responde con la factura timbrada (status valid) o, si el PAC tarda, en processing (escuche invoice.stamped). Lo que puede omitir tiene el valor usual: PUE, MXN, uso G03 (S01 con régimen 616), objeto de impuesto 02, IVA 16%, cantidad 1, unidad E48.
9547
+ * Revisa la factura con las reglas del SAT, la sella y la timbra en una sola llamada. Responde con la factura timbrada (status valid) o, si el PAC tarda o el SAT no responde, 202 en processing: Fiscalisto la reintenta sola y invoice.stamped avisa. Con async: true responde 202 de inmediato y timbra después. Lo que puede omitir tiene el valor usual: PUE, MXN, uso G03 (S01 con régimen 616), objeto de impuesto 02, IVA 16%, cantidad 1, unidad E48.
9256
9548
  *
9257
9549
  * POST /v1/invoices
9258
9550
  * @see https://fiscalisto.com/docs/api/referencia/facturas/create-invoice
@@ -10685,6 +10977,175 @@ export declare class CfdiVerificationsResource {
10685
10977
  */
10686
10978
  create(params?: VerifyCfdiParams, options?: RequestOptions): Promise<CfdiVerification>;
10687
10979
  }
10980
+ /** Equipo: fiscalisto.members. */
10981
+ export declare class MembersResource {
10982
+ #private;
10983
+ constructor(client: Client);
10984
+ /**
10985
+ * Listar miembros
10986
+ *
10987
+ * Quién entra a la empresa en la app, con su rol, sus permisos y los RFC y sucursales a su alcance, como Ajustes › Miembros. Todos, los más antiguos primero. Pide que quien creó la llave tenga el permiso de ver el equipo.
10988
+ *
10989
+ * GET /v1/members
10990
+ * @see https://fiscalisto.com/docs/api/referencia/equipo/list-members
10991
+ */
10992
+ list(params?: ListMembersParams, options?: RequestOptions): Promise<MemberList>;
10993
+ /**
10994
+ * Ver un miembro
10995
+ *
10996
+ * Su rol, sus permisos (los agregados, los quitados y los que tiene al final) y su alcance.
10997
+ *
10998
+ * GET /v1/members/{id}
10999
+ * @see https://fiscalisto.com/docs/api/referencia/equipo/get-member
11000
+ */
11001
+ get(id: string, options?: RequestOptions): Promise<Member>;
11002
+ /**
11003
+ * Cambiar el acceso de un miembro
11004
+ *
11005
+ * Su rol, los permisos que se le agregan o quitan y los RFC y sucursales a su alcance; lo que no mande se queda como está. Nadie da más de lo que tiene quien creó la llave. Dar, quitar o tocar un permiso delicado (equipo, credenciales, seguridad, plan) contesta 403 team_change_requires_app: se hace en la app, que confirma la identidad.
11006
+ *
11007
+ * POST /v1/members/{id}
11008
+ * @see https://fiscalisto.com/docs/api/referencia/equipo/update-member
11009
+ */
11010
+ update(id: string, params?: UpdateMemberParams, options?: RequestOptions): Promise<Member>;
11011
+ /**
11012
+ * Quitar a un miembro
11013
+ *
11014
+ * La persona deja de entrar a la empresa y sus invitaciones se cancelan. Siempre queda al menos un propietario; quitar a alguien con permisos delicados se hace en la app.
11015
+ *
11016
+ * DELETE /v1/members/{id}
11017
+ * @see https://fiscalisto.com/docs/api/referencia/equipo/delete-member
11018
+ */
11019
+ delete(id: string, options?: RequestOptions): Promise<Deleted>;
11020
+ }
11021
+ /** Equipo: fiscalisto.invitations. */
11022
+ export declare class InvitationsResource {
11023
+ #private;
11024
+ constructor(client: Client);
11025
+ /**
11026
+ * Listar invitaciones
11027
+ *
11028
+ * Las invitaciones pendientes de la empresa, las más antiguas primero.
11029
+ *
11030
+ * GET /v1/invitations
11031
+ * @see https://fiscalisto.com/docs/api/referencia/equipo/list-invitations
11032
+ */
11033
+ list(params?: ListInvitationsParams, options?: RequestOptions): Promise<InvitationList>;
11034
+ /**
11035
+ * Invitar a alguien a la empresa
11036
+ *
11037
+ * Le manda un correo con un enlace para entrar a la empresa con ese rol, válido 7 días, como Invitar en Ajustes › Miembros. Invitar otra vez al mismo correo reemplaza la invitación. Una invitación con permisos delicados (equipo, credenciales, seguridad, plan) o como propietario se hace en la app.
11038
+ *
11039
+ * POST /v1/invitations
11040
+ * @see https://fiscalisto.com/docs/api/referencia/equipo/create-invitation
11041
+ */
11042
+ create(params: CreateInvitationParams, options?: RequestOptions): Promise<Invitation>;
11043
+ /**
11044
+ * Cancelar una invitación
11045
+ *
11046
+ * Su enlace deja de servir. Contesta la invitación con status canceled.
11047
+ *
11048
+ * DELETE /v1/invitations/{id}
11049
+ * @see https://fiscalisto.com/docs/api/referencia/equipo/cancel-invitation
11050
+ */
11051
+ cancel(id: string, options?: RequestOptions): Promise<Invitation>;
11052
+ }
11053
+ /** Equipo: fiscalisto.roles. */
11054
+ export declare class RolesResource {
11055
+ #private;
11056
+ constructor(client: Client);
11057
+ /**
11058
+ * Listar roles
11059
+ *
11060
+ * Propietario, los roles de Fiscalisto (como se editaron en la empresa) y los suyos, con sus permisos y cuántas personas los tienen.
11061
+ *
11062
+ * GET /v1/roles
11063
+ * @see https://fiscalisto.com/docs/api/referencia/equipo/list-roles
11064
+ */
11065
+ list(params?: ListRolesParams, options?: RequestOptions): Promise<RoleList>;
11066
+ /**
11067
+ * Crear un rol
11068
+ *
11069
+ * Un rol de la empresa con su nombre y sus permisos (GET /v1/permissions), como Ajustes › Roles. No puede tener permisos que no tenga quien creó la llave; uno con permisos delicados se hace en la app.
11070
+ *
11071
+ * POST /v1/roles
11072
+ * @see https://fiscalisto.com/docs/api/referencia/equipo/create-role
11073
+ */
11074
+ create(params: CreateRoleParams, options?: RequestOptions): Promise<Role>;
11075
+ /**
11076
+ * Cambiar un rol
11077
+ *
11078
+ * Su nombre, su descripción o sus permisos; lo que no mande se queda. Cambia el acceso de todos los que lo tienen. Propietario no se cambia.
11079
+ *
11080
+ * POST /v1/roles/{id}
11081
+ * @see https://fiscalisto.com/docs/api/referencia/equipo/update-role
11082
+ */
11083
+ update(id: string, params?: UpdateRoleParams, options?: RequestOptions): Promise<Role>;
11084
+ /**
11085
+ * Borrar un rol
11086
+ *
11087
+ * Solo uno de la empresa (type custom), cuando nadie lo tiene ni lo da una invitación pendiente.
11088
+ *
11089
+ * DELETE /v1/roles/{id}
11090
+ * @see https://fiscalisto.com/docs/api/referencia/equipo/delete-role
11091
+ */
11092
+ delete(id: string, params?: DeleteRoleParams, options?: RequestOptions): Promise<Deleted>;
11093
+ }
11094
+ /** Equipo: fiscalisto.permissions. */
11095
+ export declare class PermissionsResource {
11096
+ #private;
11097
+ constructor(client: Client);
11098
+ /**
11099
+ * Listar permisos
11100
+ *
11101
+ * Cada permiso que un rol o una persona puede tener, con su nombre en la app, su grupo y si es delicado.
11102
+ *
11103
+ * GET /v1/permissions
11104
+ * @see https://fiscalisto.com/docs/api/referencia/equipo/list-permissions
11105
+ */
11106
+ list(options?: RequestOptions): Promise<PermissionList>;
11107
+ }
11108
+ /** Exportaciones: fiscalisto.exports. */
11109
+ export declare class ExportsResource {
11110
+ #private;
11111
+ constructor(client: Client);
11112
+ /**
11113
+ * Exportar las facturas de un mes
11114
+ *
11115
+ * Un ZIP con el XML (y si quiere el PDF) de cada factura que el emisor emitió o recibió en un mes o un periodo, o un Excel con una fila por factura: los mismos archivos que Facturas › Exportar en la app, para su contador, un respaldo o una auditoría. Contesta 202 de inmediato con status processing; consulte GET /v1/exports/{id} hasta completed y descárguelo con GET /v1/exports/{id}/download durante 30 días. No usa timbres y sirve con una llave de solo lectura.
11116
+ *
11117
+ * POST /v1/exports
11118
+ * @see https://fiscalisto.com/docs/api/referencia/exportaciones/create-export
11119
+ */
11120
+ create(params?: CreateExportParams, options?: RequestOptions): Promise<Export>;
11121
+ /**
11122
+ * Listar exportaciones
11123
+ *
11124
+ * Las exportaciones del emisor pedidas por la API, las más recientes primero.
11125
+ *
11126
+ * GET /v1/exports
11127
+ * @see https://fiscalisto.com/docs/api/referencia/exportaciones/list-exports
11128
+ */
11129
+ list(params?: ListExportsParams, options?: RequestOptions): List<Export>;
11130
+ /**
11131
+ * Ver una exportación
11132
+ *
11133
+ * Su estado (processing, completed, failed o expired), cuántas facturas lleva, su tamaño y hasta cuándo se descarga.
11134
+ *
11135
+ * GET /v1/exports/{id}
11136
+ * @see https://fiscalisto.com/docs/api/referencia/exportaciones/get-export
11137
+ */
11138
+ get(id: string, options?: RequestOptions): Promise<Export>;
11139
+ /**
11140
+ * Descargar una exportación
11141
+ *
11142
+ * El ZIP o el Excel, cuando status es completed. Antes, 409 export_not_ready; pasados 30 días, 410 export_expired.
11143
+ *
11144
+ * GET /v1/exports/{id}/download
11145
+ * @see https://fiscalisto.com/docs/api/referencia/exportaciones/download-export
11146
+ */
11147
+ download(id: string, options?: RequestOptions): Promise<string>;
11148
+ }
10688
11149
  /** Descargas del SAT: fiscalisto.satDownloads. */
10689
11150
  export declare class SatDownloadsResource {
10690
11151
  #private;
@@ -11600,6 +12061,11 @@ export declare class FiscalistoApi extends Core {
11600
12061
  readonly satCatalogs: SatCatalogsResource;
11601
12062
  readonly satLists: SatListsResource;
11602
12063
  readonly cfdiVerifications: CfdiVerificationsResource;
12064
+ readonly members: MembersResource;
12065
+ readonly invitations: InvitationsResource;
12066
+ readonly roles: RolesResource;
12067
+ readonly permissions: PermissionsResource;
12068
+ readonly exports: ExportsResource;
11603
12069
  readonly satDownloads: SatDownloadsResource;
11604
12070
  readonly satInvoices: SatInvoicesResource;
11605
12071
  readonly satRetentions: SatRetentionsResource;