fiscalisto 0.1.52 → 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.
@@ -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: {
@@ -1060,6 +1060,217 @@ export interface ExternalPayrollReceiptPreview {
1060
1060
  /** El XML que se mandaría al PAC, sin sello ni timbre: sus importes son exactamente los que mandó. */
1061
1061
  unsigned_xml: string;
1062
1062
  }
1063
+ /** Una factura revisada y sin timbrar: lo que se timbraría ahora con POST /v1/invoices y el mismo cuerpo. */
1064
+ export interface InvoicePreview {
1065
+ /** Qué tipo de objeto es («invoice», «customer»…). */
1066
+ object: "invoice_preview";
1067
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
1068
+ livemode: boolean;
1069
+ /** El emisor (iss_…). */
1070
+ issuer: string;
1071
+ /** Sucursal (brn_…) desde donde se factura: su código postal va en LugarExpedicion, su dirección en el PDF y, si las tiene, sus series. Sin ella, el domicilio fiscal del emisor (la Matriz). */
1072
+ branch: string | null;
1073
+ /** Tipo de comprobante (TipoDeComprobante): I ingreso, E egreso, P pago, T traslado, N nómina. */
1074
+ type: "I" | "E" | "T";
1075
+ /** Serie (Serie), hasta 25 caracteres. Cada serie lleva sus propios folios. */
1076
+ series: string | null;
1077
+ /** El folio que tendría si se timbrara ahora; otra factura timbrada antes puede tomarlo. */
1078
+ folio: string | null;
1079
+ /** Fecha de emisión (Fecha), hora de la Ciudad de México. */
1080
+ date: string | null;
1081
+ /** Cliente (Receptor): el id de uno de su catálogo (cus_…) o sus datos en un objeto. */
1082
+ customer: {
1083
+ /** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
1084
+ tax_id: string | null;
1085
+ /** Nombre o razón social tal como está en la constancia de situación fiscal, sin el régimen de capital (sin «S.A. de C.V.»). */
1086
+ legal_name: string | null;
1087
+ /** Régimen fiscal (RegimenFiscal), clave de c_RegimenFiscal: 601, 612, 626… */
1088
+ tax_system?: string;
1089
+ /** Código postal del domicilio fiscal del cliente (DomicilioFiscalReceptor), 5 dígitos. */
1090
+ zip?: string;
1091
+ /** Si es extranjero: su país de residencia (ResidenciaFiscal, c_Pais) y su número de registro tributario (NumRegIdTrib), con el RFC genérico XEXX010101000. */
1092
+ foreign?: Record<string, unknown>;
1093
+ };
1094
+ /** Uso del CFDI (UsoCFDI), clave de c_UsoCFDI. Por omisión G03, o S01 con régimen 616. */
1095
+ use: string | null;
1096
+ /** Forma de pago (FormaPago), clave de c_FormaPago: 01 efectivo, 03 transferencia, 04 tarjeta de crédito, 28 débito, 99 por definir… Obligatoria con PUE; con PPD es 99. */
1097
+ payment_form: string | null;
1098
+ /** Método de pago (MetodoPago): PUE (una sola exhibición, por omisión) o PPD (en parcialidades o diferido, se cobra con complementos de pago). */
1099
+ payment_method: string | null;
1100
+ /** Moneda, clave ISO 4217 de c_Moneda (MXN, USD, EUR…). Por omisión MXN. */
1101
+ currency: string;
1102
+ /** Tipo de cambio a pesos (TipoCambio). Obligatorio si la moneda no es MXN; use el del DOF del día anterior. */
1103
+ exchange_rate: number | null;
1104
+ /** Conceptos (Conceptos), al menos uno. */
1105
+ items: InvoiceItem[];
1106
+ /** Suma de los importes antes de impuestos y descuentos (SubTotal). */
1107
+ subtotal: number | null;
1108
+ /** Descuento (Descuento). */
1109
+ discount: number | null;
1110
+ /** Los impuestos de la factura, por tipo: IVA e IEPS trasladados, IVA e ISR retenidos e impuestos locales. */
1111
+ taxes: {
1112
+ /** IVA trasladado. */
1113
+ iva: number | null;
1114
+ /** IEPS trasladado. */
1115
+ ieps: number | null;
1116
+ /** IVA retenido. */
1117
+ iva_withheld: number | null;
1118
+ /** ISR retenido. */
1119
+ isr_withheld: number | null;
1120
+ /** Impuestos locales trasladados. */
1121
+ local_transferred: number | null;
1122
+ /** Impuestos locales retenidos. */
1123
+ local_withheld: number | null;
1124
+ } | null;
1125
+ /** Total en la moneda del comprobante (Total). */
1126
+ total: number;
1127
+ /** Lo que conviene revisar antes de timbrar (un cliente en las listas 69 o 69-B del SAT, una factura que parece duplicada); no impide timbrar. */
1128
+ warnings: {
1129
+ /** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves 14, 16, 17 y 18 a 24 llevan su complemento (dividends, interest, trust_lease, foreign_payment, share_sale, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); la 26 (plataformas tecnológicas) lleva platform, y sus totals y taxes se calculan de las operaciones. */
1130
+ code: string;
1131
+ /** Qué pasó y cómo corregirlo, para una persona. */
1132
+ message: string;
1133
+ }[];
1134
+ /** El XML que se mandaría al PAC, sin sello ni timbre. */
1135
+ unsigned_xml: string;
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
+ }
1063
1274
  /** Un anticipo timbrado que aún no se aplica. */
1064
1275
  export interface Advance {
1065
1276
  /** Qué tipo de objeto es («invoice», «customer»…). */
@@ -1363,6 +1574,46 @@ export interface SatListCheck {
1363
1574
  /** Las listas que no se pudieron confirmar (su última actualización falló, falta o tiene más de dos días). Vacía si todas están al día. */
1364
1575
  lists_unavailable: string[];
1365
1576
  }
1577
+ /** Si los sellos del XML son auténticos, como los revisa el SAT: el Sello del emisor contra la cadena original y su certificado, y el SelloSAT del timbre contra el certificado del SAT. */
1578
+ export interface CfdiSeals {
1579
+ /** true si no hay ningún problema: el Sello corresponde a los datos y al certificado del emisor (un CSD de su RFC, vigente en la fecha de emisión) y el timbre es de este comprobante y del SAT. */
1580
+ valid: boolean;
1581
+ /** Si el Sello del emisor firma la cadena original de este XML con la llave del certificado que trae. false si alguien cambió un monto, un nombre o una fecha después de sellar. */
1582
+ issuer_seal_valid: boolean;
1583
+ /** El certificado del emisor que trae el XML (Certificado): número, RFC, nombre, si es CSD o e.firma y su vigencia. null si no se pudo leer. */
1584
+ certificate: {
1585
+ /** El número del certificado (20 dígitos), como lo da el SAT. */
1586
+ number: string;
1587
+ /** El RFC dueño del certificado. */
1588
+ tax_id: string | null;
1589
+ /** El nombre o razón social en el certificado. */
1590
+ name: string | null;
1591
+ /** csd si es un sello digital; fiel si es una e.firma (no se debe sellar con ella). */
1592
+ kind: "csd" | "fiel";
1593
+ /** Desde cuándo vale el certificado. */
1594
+ valid_from: string;
1595
+ /** Hasta cuándo vale el certificado. */
1596
+ valid_to: string;
1597
+ } | null;
1598
+ /** El timbre (TimbreFiscalDigital): si su SelloSAT es del SAT, con qué certificado del SAT y qué PAC lo timbró. null si el XML no está timbrado. */
1599
+ stamp: {
1600
+ /** Si el SelloSAT firma el timbre con el certificado del SAT (NoCertificadoSAT). null si el certificado del SAT no se pudo obtener en ese momento. */
1601
+ sat_seal_valid: boolean | null;
1602
+ /** El número del certificado del SAT que selló el timbre. */
1603
+ sat_certificate_number: string;
1604
+ /** El RFC del PAC que timbró (RfcProvCertif). */
1605
+ pac_tax_id: string | null;
1606
+ } | null;
1607
+ /** Cada problema, con su código y qué significa. Vacía si valid es true. */
1608
+ problems: {
1609
+ /** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves 14, 16, 17 y 18 a 24 llevan su complemento (dividends, interest, trust_lease, foreign_payment, share_sale, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); la 26 (plataformas tecnológicas) lleva platform, y sus totals y taxes se calculan de las operaciones. */
1610
+ code: "malformed_xml" | "missing_seal" | "certificate_unreadable" | "certificate_number_mismatch" | "certificate_not_issuer" | "certificate_not_csd" | "certificate_not_valid_at_issue" | "seal_mismatch" | "stamp_not_for_this_seal" | "sat_seal_mismatch";
1611
+ /** Qué pasó y cómo corregirlo, para una persona. */
1612
+ message: string;
1613
+ }[];
1614
+ /** La cadena original del comprobante, como la arma el SAT con sus XSLT. null si el XML no se pudo leer. */
1615
+ original_string: string | null;
1616
+ }
1366
1617
  /** Si los datos fiscales de un cliente van a pasar el SAT. */
1367
1618
  export interface TaxIdValidation {
1368
1619
  /** Qué tipo de objeto es («invoice», «customer»…). */
@@ -4033,6 +4284,54 @@ export interface EventResend {
4033
4284
  /** A cuántos webhooks salió. 0 si ninguno encendido escucha ese tipo de evento. */
4034
4285
  deliveries: number;
4035
4286
  }
4287
+ /** Cómo se ven los documentos de un emisor: nombre comercial, estilo y color del PDF, y logo. */
4288
+ export interface IssuerBranding {
4289
+ /** Qué tipo de objeto es («invoice», «customer»…). */
4290
+ object: "issuer_branding";
4291
+ /** El emisor (iss_…). */
4292
+ issuer: string;
4293
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
4294
+ livemode: boolean;
4295
+ /** Su nombre comercial: va en grande en el PDF, el correo y la página de la factura; null: la razón social. */
4296
+ trade_name: string | null;
4297
+ /** Estilo del PDF: clasico, moderno, compacto o minimalista; null: clasico. */
4298
+ pdf_style: "clasico" | "moderno" | "compacto" | "minimalista" | null;
4299
+ /** Color del PDF (#RRGGBB); null: el de Fiscalisto (#5B48EE). */
4300
+ pdf_color: string | null;
4301
+ /** Dirección pública del logo; null si no tiene. */
4302
+ logo_url: string | null;
4303
+ }
4304
+ /** Lo que pasó con un evento en un webhook: su último intento, cuántos lleva y cuándo va el siguiente. */
4305
+ export interface WebhookDelivery {
4306
+ /** Qué tipo de objeto es («invoice», «customer»…). */
4307
+ object: "webhook_delivery";
4308
+ /** El último intento (whd_…). Úselo en starting_after para la página siguiente. */
4309
+ id: string;
4310
+ /** El webhook (whe_…). */
4311
+ webhook_endpoint: string;
4312
+ /** El evento (evt_…). Reenvíelo con POST /v1/events/{id}/resend. */
4313
+ event: string;
4314
+ /** El tipo del evento (invoice.stamped…). */
4315
+ event_type: string | null;
4316
+ /** true si su servidor contestó 2xx en el último intento. */
4317
+ succeeded: boolean;
4318
+ /** El código HTTP que contestó su servidor; null si no se pudo conectar. */
4319
+ status: number | null;
4320
+ /** Qué falló (tiempo de espera, DNS, o el inicio de su respuesta); null si llegó. */
4321
+ error: string | null;
4322
+ /** Cuánto tardó su servidor en contestar el último intento. */
4323
+ duration_ms: number;
4324
+ /** Cuántas veces se ha mandado a este webhook, reenvíos incluidos. */
4325
+ attempts: number;
4326
+ /** true si el último intento fue un reenvío (POST /v1/events/{id}/resend). */
4327
+ resent: boolean;
4328
+ /** true si es un evento de prueba (POST /v1/webhook_endpoints/{id}/test); no se reintenta. */
4329
+ test: boolean;
4330
+ /** Cuándo fue el último intento. */
4331
+ created_at: string;
4332
+ /** Cuándo va el siguiente reintento automático; null si llegó o ya no hay más. */
4333
+ next_retry_at: string | null;
4334
+ }
4036
4335
  /** Lo que dice el SAT de un CFDI: si existe, si está vigente o cancelado y si se puede cancelar, con su emisor y su receptor en las listas del SAT. */
4037
4336
  export interface CfdiVerification {
4038
4337
  /** Qué tipo de objeto es («invoice», «customer»…). */
@@ -4087,6 +4386,8 @@ export interface CfdiVerification {
4087
4386
  /** Moneda, clave ISO 4217 de c_Moneda (MXN, USD, EUR…). Por omisión MXN. */
4088
4387
  currency: string | null;
4089
4388
  } | null;
4389
+ /** Los sellos del XML, si mandó xml de un CFDI 4.0: si el comprobante no se modificó después de sellarse y si el timbre es del SAT. null con qr o fields, o con un CFDI 3.3. */
4390
+ seals: CfdiSeals | null;
4090
4391
  /** El emisor en las listas del SAT (69-B, 69-B Bis y art. 69), como GET /v1/sat_lists/{tax_id}, sin costo. Solo cuando el SAT tiene el comprobante (active o canceled); null si no, o si las listas no se pudieron leer. */
4091
4392
  issuer_sat_lists: SatListCheck | null;
4092
4393
  /** El receptor en las listas del SAT, igual que el emisor. */
@@ -4448,6 +4749,56 @@ export interface SatListCheckList {
4448
4749
  /** La ruta de esta lista. */
4449
4750
  url: string;
4450
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
+ }
4451
4802
  export interface SatDownloadList {
4452
4803
  /** Qué tipo de objeto es («invoice», «customer»…). */
4453
4804
  object: "list";
@@ -4588,6 +4939,16 @@ export interface WebhookEndpointList {
4588
4939
  /** La ruta de esta lista. */
4589
4940
  url: string;
4590
4941
  }
4942
+ export interface WebhookDeliveryList {
4943
+ /** Qué tipo de objeto es («invoice», «customer»…). */
4944
+ object: "list";
4945
+ /** Los objetos de esta página. */
4946
+ data: WebhookDelivery[];
4947
+ /** true si hay más: pida la siguiente con starting_after igual al id del último. */
4948
+ has_more: boolean;
4949
+ /** La ruta de esta lista. */
4950
+ url: string;
4951
+ }
4591
4952
  export interface EventList {
4592
4953
  /** Qué tipo de objeto es («invoice», «customer»…). */
4593
4954
  object: "list";
@@ -5409,6 +5770,8 @@ export interface InvoiceCreate {
5409
5770
  email_cc?: string | null;
5410
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. */
5411
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;
5412
5775
  }
5413
5776
  /** Un recibo de nómina que calculó su sistema, con todos sus conceptos e importes: se timbra tal cual. */
5414
5777
  export interface ExternalPayrollReceiptCreate {
@@ -5718,6 +6081,18 @@ export interface UploadCertificateParams {
5718
6081
  /** La contraseña de la llave privada (.key). Se usa para abrirla y no se guarda en texto. */
5719
6082
  password: string;
5720
6083
  }
6084
+ export interface UpdateIssuerBrandingParams {
6085
+ /** Su nombre comercial, si se presenta con otra marca: va en grande en el PDF, en el correo y en la página de la factura. null: la razón social. */
6086
+ trade_name?: string | null;
6087
+ /** Estilo del PDF: clasico (por omisión), moderno (encabezado y total con color, renglones alternados), compacto (letra chica, márgenes cortos) o minimalista (sin rellenos, el color solo en el total). */
6088
+ pdf_style?: "clasico" | "moderno" | "compacto" | "minimalista" | null;
6089
+ /** Color del PDF, como #2563EB. null: el de Fiscalisto (#5B48EE). */
6090
+ pdf_color?: string | null;
6091
+ }
6092
+ export interface UploadIssuerLogoParams {
6093
+ /** El logo, PNG o JPG de hasta 1 MB, en base64 (con o sin el prefijo data:image/png;base64,). Uno muy grande se reduce para el PDF. */
6094
+ file: string;
6095
+ }
5721
6096
  export interface SignEfirmaParams {
5722
6097
  /** El archivo .cer en base64 (puede traer el prefijo data:). */
5723
6098
  cer: string;
@@ -5778,6 +6153,11 @@ export interface GetInvoiceXmlParams {
5778
6153
  /** Con un UUID en vez del id, el emisor (iss_…) si la cuenta tiene varios. */
5779
6154
  issuer?: string;
5780
6155
  }
6156
+ /** Los parámetros de GET /v1/invoices/{id}/cancellation_receipt. */
6157
+ export interface GetInvoiceCancellationReceiptParams {
6158
+ /** Con un UUID en vez del id, el emisor (iss_…) si la cuenta tiene varios. */
6159
+ issuer?: string;
6160
+ }
5781
6161
  export interface SendInvoiceParams {
5782
6162
  /** A quién (correos separados por comas). */
5783
6163
  to?: string;
@@ -7513,6 +7893,109 @@ export interface VerifyCfdiParams {
7513
7893
  /** El total del comprobante, sin XML ni QR. El SAT lo compara como número. */
7514
7894
  total?: number;
7515
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
+ }
7516
7999
  export interface CreateSatDownloadParams {
7517
8000
  /** El emisor (iss_…). Por omisión, su único emisor. */
7518
8001
  issuer?: string;
@@ -8692,6 +9175,15 @@ export interface TestWebhookEndpointParams {
8692
9175
  /** El evento a mandar. Por omisión invoice.stamped. */
8693
9176
  type?: "invoice.stamped" | "invoice.failed" | "invoice.canceled" | "invoice.cancellation_pending" | "invoice.cancellation_rejected" | "invoice.paid" | "invoice.partially_paid" | "invoice.email_bounced" | "invoice.email_complained" | "retention.stamped" | "retention.failed" | "retention.canceled" | "invoice_batch.completed" | "payroll_batch.completed" | "customer_data_request.completed" | "sat_download.completed" | "sat_download.failed" | "sat_declaration.created" | "sat_declaration.updated" | "ticket.invoiced" | "ticket.included_in_global" | "recurring_invoice.failed" | "quote.viewed" | "quote.accepted" | "quote.changes_requested" | "quote.rejected" | "quote.withdrawn" | "sales_order.confirmed" | "sales_order.customer_confirmed" | "sales_order.delivered" | "sales_order.paid" | "sales_order.canceled" | "supplier_invoice.received" | "supplier_invoice.approved" | "supplier_invoice.rejected" | "supplier_invoice.scheduled" | "supplier_invoice.paid" | "portal_supplier.approved" | "issuer.ready" | "balance.low" | "usage.high" | "test_clock.ready";
8694
9177
  }
9178
+ /** Los parámetros de GET /v1/webhook_endpoints/{id}/deliveries. */
9179
+ export interface ListWebhookDeliveriesParams {
9180
+ /** Cuántos por página, de 1 a 100. Por omisión 10. */
9181
+ limit?: number;
9182
+ /** El id del último de la página anterior, para la siguiente. */
9183
+ starting_after?: string;
9184
+ /** false: solo los que fallaron en su último intento. true: solo los que llegaron. */
9185
+ succeeded?: boolean;
9186
+ }
8695
9187
  /** Los parámetros de GET /v1/events. */
8696
9188
  export interface ListEventsParams {
8697
9189
  /** Cuántos por página, de 1 a 100. Por omisión 10. */
@@ -8900,6 +9392,42 @@ export declare class IssuersResource {
8900
9392
  * @see https://fiscalisto.com/docs/api/referencia/emisores/upload-certificate
8901
9393
  */
8902
9394
  uploadCertificate(id: string, params: UploadCertificateParams, options?: RequestOptions): Promise<Issuer>;
9395
+ /**
9396
+ * Ver el diseño del PDF
9397
+ *
9398
+ * Cómo se ven los documentos del emisor: su nombre comercial, el estilo y el color del PDF y su logo. Es lo mismo que Ajustes › Marca y documentos en la app.
9399
+ *
9400
+ * GET /v1/issuers/{id}/branding
9401
+ * @see https://fiscalisto.com/docs/api/referencia/emisores/get-issuer-branding
9402
+ */
9403
+ getBranding(id: string, options?: RequestOptions): Promise<IssuerBranding>;
9404
+ /**
9405
+ * Cambiar el diseño del PDF
9406
+ *
9407
+ * Cambia el nombre comercial, el estilo (clasico, moderno, compacto o minimalista) y el color del PDF de las facturas, notas, pagos, recibos y cotizaciones del emisor, y de sus correos. Lo que no mande se queda como está; null vuelve al de omisión. Se ve en el siguiente PDF que pida, también de lo ya timbrado. Una sucursal puede tener el suyo (POST /v1/branches/{id}).
9408
+ *
9409
+ * POST /v1/issuers/{id}/branding
9410
+ * @see https://fiscalisto.com/docs/api/referencia/emisores/update-issuer-branding
9411
+ */
9412
+ updateBranding(id: string, params?: UpdateIssuerBrandingParams, options?: RequestOptions): Promise<IssuerBranding>;
9413
+ /**
9414
+ * Subir el logo
9415
+ *
9416
+ * El logo del emisor (PNG o JPG de hasta 1 MB, en base64): va en sus PDF, sus correos y la página de la factura que ve su cliente. Reemplaza el anterior.
9417
+ *
9418
+ * POST /v1/issuers/{id}/logo
9419
+ * @see https://fiscalisto.com/docs/api/referencia/emisores/upload-issuer-logo
9420
+ */
9421
+ uploadLogo(id: string, params: UploadIssuerLogoParams, options?: RequestOptions): Promise<IssuerBranding>;
9422
+ /**
9423
+ * Quitar el logo
9424
+ *
9425
+ * Sus PDF y correos van sin logo, con su nombre.
9426
+ *
9427
+ * DELETE /v1/issuers/{id}/logo
9428
+ * @see https://fiscalisto.com/docs/api/referencia/emisores/delete-issuer-logo
9429
+ */
9430
+ deleteLogo(id: string, options?: RequestOptions): Promise<IssuerBranding>;
8903
9431
  /**
8904
9432
  * Firmar el contrato con el PAC
8905
9433
  *
@@ -9016,7 +9544,7 @@ export declare class InvoicesResource {
9016
9544
  /**
9017
9545
  * Timbrar una factura
9018
9546
  *
9019
- * 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.
9020
9548
  *
9021
9549
  * POST /v1/invoices
9022
9550
  * @see https://fiscalisto.com/docs/api/referencia/facturas/create-invoice
@@ -9031,6 +9559,15 @@ export declare class InvoicesResource {
9031
9559
  * @see https://fiscalisto.com/docs/api/referencia/facturas/list-invoices
9032
9560
  */
9033
9561
  list(params?: ListInvoicesParams, options?: RequestOptions): List<Invoice>;
9562
+ /**
9563
+ * Revisar una factura sin timbrar
9564
+ *
9565
+ * El mismo cuerpo y las mismas revisiones que POST /v1/invoices, sin timbrar ni usar timbres: devuelve la factura como se timbraría ahora (con los datos fiscales del emisor, el siguiente folio, el subtotal, los impuestos y el total que calcula Fiscalisto), los avisos (un cliente en las listas del SAT, un duplicado) y el XML sin sellar (unsigned_xml). Úsela para mostrar el total antes de cobrar o para validar en su sistema; si algo falla, invoice_invalid como al timbrar. No pide Idempotency-Key y sirve con una llave de solo lectura.
9566
+ *
9567
+ * POST /v1/invoices/preview
9568
+ * @see https://fiscalisto.com/docs/api/referencia/facturas/preview-invoice
9569
+ */
9570
+ preview(params: InvoiceCreate, options?: RequestOptions): Promise<InvoicePreview>;
9034
9571
  /**
9035
9572
  * Ver una factura
9036
9573
  *
@@ -9067,6 +9604,15 @@ export declare class InvoicesResource {
9067
9604
  * @see https://fiscalisto.com/docs/api/referencia/facturas/get-invoice-xml
9068
9605
  */
9069
9606
  xml(id: string, params?: GetInvoiceXmlParams, options?: RequestOptions): Promise<string>;
9607
+ /**
9608
+ * Descargar el acuse de cancelación
9609
+ *
9610
+ * El acuse de cancelación del SAT (XML firmado por el SAT) de una factura cancelada: la prueba de que el SAT la canceló y cuándo. Antes de que el SAT la cancele (status valid o pending), 409 invoice_not_canceled.
9611
+ *
9612
+ * GET /v1/invoices/{id}/cancellation_receipt
9613
+ * @see https://fiscalisto.com/docs/api/referencia/facturas/get-invoice-cancellation-receipt
9614
+ */
9615
+ cancellationReceipt(id: string, params?: GetInvoiceCancellationReceiptParams, options?: RequestOptions): Promise<string>;
9070
9616
  /**
9071
9617
  * Enviar por correo
9072
9618
  *
@@ -10431,6 +10977,175 @@ export declare class CfdiVerificationsResource {
10431
10977
  */
10432
10978
  create(params?: VerifyCfdiParams, options?: RequestOptions): Promise<CfdiVerification>;
10433
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
+ }
10434
11149
  /** Descargas del SAT: fiscalisto.satDownloads. */
10435
11150
  export declare class SatDownloadsResource {
10436
11151
  #private;
@@ -11260,6 +11975,15 @@ export declare class WebhookEndpointsResource {
11260
11975
  * @see https://fiscalisto.com/docs/api/referencia/webhooks/test-webhook-endpoint
11261
11976
  */
11262
11977
  test(id: string, params?: TestWebhookEndpointParams, options?: RequestOptions): Promise<WebhookTest>;
11978
+ /**
11979
+ * Listar entregas
11980
+ *
11981
+ * Qué pasó con cada evento en este webhook, el más reciente primero: una fila por evento con su último intento, cuántos lleva y cuándo va el siguiente reintento. Con succeeded=false ve los que su servidor no recibió, para reenviarlos con POST /v1/events/{id}/resend.
11982
+ *
11983
+ * GET /v1/webhook_endpoints/{id}/deliveries
11984
+ * @see https://fiscalisto.com/docs/api/referencia/webhooks/list-webhook-deliveries
11985
+ */
11986
+ listDeliveries(id: string, params?: ListWebhookDeliveriesParams, options?: RequestOptions): List<WebhookDelivery>;
11263
11987
  }
11264
11988
  /** Eventos: fiscalisto.events. */
11265
11989
  export declare class EventsResource {
@@ -11337,6 +12061,11 @@ export declare class FiscalistoApi extends Core {
11337
12061
  readonly satCatalogs: SatCatalogsResource;
11338
12062
  readonly satLists: SatListsResource;
11339
12063
  readonly cfdiVerifications: CfdiVerificationsResource;
12064
+ readonly members: MembersResource;
12065
+ readonly invitations: InvitationsResource;
12066
+ readonly roles: RolesResource;
12067
+ readonly permissions: PermissionsResource;
12068
+ readonly exports: ExportsResource;
11340
12069
  readonly satDownloads: SatDownloadsResource;
11341
12070
  readonly satInvoices: SatInvoicesResource;
11342
12071
  readonly satRetentions: SatRetentionsResource;