evo360-types 1.3.784 → 1.3.791
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/apps/evo-chat/forward/zod-schemas.d.ts +4 -4
- package/dist/apps/evo-finops/zod-schemas.d.ts +467 -32
- package/dist/apps/evo-finops/zod-schemas.js +123 -2
- package/dist/apps/evo-finops/zod-schemas.ts +131 -0
- package/dist/types/evo-finops/common/billing-statement.d.ts +97 -0
- package/dist/types/evo-finops/common/billing-statement.js +19 -0
- package/dist/types/evo-finops/common/billing-statement.ts +101 -0
- package/dist/types/evo-finops/common/billing.d.ts +9 -0
- package/dist/types/evo-finops/common/billing.ts +12 -0
- package/dist/types/evo-finops/common/contract.d.ts +15 -0
- package/dist/types/evo-finops/common/contract.ts +16 -0
- package/dist/types/evo-finops/common/proposal.d.ts +25 -0
- package/dist/types/evo-finops/common/proposal.ts +28 -0
- package/dist/types/evo-finops/index.d.ts +1 -0
- package/dist/types/evo-finops/index.js +1 -0
- package/dist/types/evo-finops/index.ts +1 -0
- package/dist/types/nex-vendas/adhesion.d.ts +253 -0
- package/dist/types/nex-vendas/adhesion.js +15 -0
- package/dist/types/nex-vendas/adhesion.ts +280 -0
- package/dist/types/nex-vendas/index.d.ts +3 -0
- package/dist/types/nex-vendas/index.js +3 -0
- package/dist/types/nex-vendas/index.ts +3 -0
- package/dist/types/nex-vendas/journey.d.ts +82 -4
- package/dist/types/nex-vendas/journey.ts +86 -3
- package/dist/types/nex-vendas/notifications.d.ts +14 -0
- package/dist/types/nex-vendas/notifications.js +21 -0
- package/dist/types/nex-vendas/notifications.ts +21 -0
- package/dist/types/nex-vendas/offer.d.ts +129 -0
- package/dist/types/nex-vendas/offer.js +10 -0
- package/dist/types/nex-vendas/offer.ts +154 -0
- package/package.json +1 -1
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
3
|
exports.zServiceTaxInfoSchema = exports.zServiceLineItemSchema = exports.zServiceInvoiceStateSchema = exports.zProviderServiceInvoiceStatusSchema = exports.zExternalLinkSchema = exports.zExternalObjectTypeSchema = exports.zInvoiceSourceRefSchema = exports.zInvoiceSourceTypeSchema = exports.zInvoiceTakerRefSchema = exports.zInvoiceTakerSnapshotSchema = exports.zInvoiceTakerSnapshotAddressSchema = exports.zTakerDocumentSchema = exports.zTakerTaxProfileSchema = exports.zTakerProviderRefsSchema = exports.zTakerAddressSchema = exports.zInvoiceTakerTypeSchema = exports.zServiceSchema = exports.zCustomerServiceTaxInfoSchema = exports.zIssuerTaxProfileSchema = exports.zIssuerNfseConfigSchema = exports.zIssuerMunicipalCredentialsRefSchema = exports.zIssuerTaxRegimeSchema = exports.zIssuerCompanyIdentitySchema = exports.zIssuerCompanyAddressSchema = exports.zTaxProfileSyncStateSchema = exports.zAsaasProviderSchema = exports.zAsaasProviderAsaasBlockSchema = exports.zAsaasProviderCapabilitiesSchema = exports.zAsaasPaymentsCapabilitiesSchema = exports.zAsaasEnvFlagSchema = exports.zAsaasNfseCapabilitiesSchema = exports.zAsaasEnvAuthConfigSchema = exports.zAsaasSubaccountInputSchema = exports.zAsaasAccountScopeSchema = exports.zAsaasWebhookConfigSchema = exports.zRetryPolicySchema = exports.zAsaasWebhookEventSchema = exports.zAsaasAccountScopeModeSchema = exports.zProviderRemoteRefsSchema = exports.zProviderFiscalInfoPayloadSchema = exports.zProviderCredentialsInputSchema = exports.zProviderCredentialsSecretRefsSchema = exports.zProviderMunicipalOptionsSnapshotSchema = exports.zProviderOptionItemSchema = exports.zProviderMunicipalAuthTypeSchema = exports.zFinopsProviderBaseSchema = exports.zProviderStatusSchema = exports.zFinopsActionSchema = exports.zFinopsProviderTypeSchema = exports.zProviderEnvSchema = void 0;
|
|
4
|
-
exports.
|
|
5
|
-
exports.zNfseFeeReimbursementExecuteSchema = exports.zNfseFeeReimbursementCompetenciaSchema = exports.zNexFinopsPaymentMethodsDiscoverSchema = exports.zNexFinopsBillingCardChargeSweepSchema = exports.zEvoBillingPortalCardCaptureSchema = exports.zNexFinopsBillingCardChargeSchema = void 0;
|
|
4
|
+
exports.zNexFinopsPaymentMethodStatusSchema = exports.zNexFinopsPaymentMethodKindSchema = exports.zNexFinopsPriceTableWriteSchema = exports.zNexFinopsPriceLinesSchema = exports.zNexFinopsPriceLineSchema = exports.zNexFinopsPriceCapSchema = exports.zNexFinopsPriceCapTierSchema = exports.zNexFinopsContractAllowancesWriteSchema = exports.zNexFinopsUsageAlertDefaultsSchema = exports.zNexFinopsAlertThresholdSchema = exports.zNexFinopsContractAllowancesSchema = exports.zNexFinopsContractAllowanceSchema = exports.zNexVendasJourneyPaymentSchema = exports.zNexVendasJourneyPaymentSupersededSchema = exports.zNexVendasJourneyPaymentWebhookEventSchema = exports.zNexVendasJourneyBoletoSchema = exports.zNexVendasJourneyPaymentChooseSchema = exports.zNexVendasJourneyPaymentStateSchema = exports.zNexVendasJourneyPaymentKindSchema = exports.zNexVendasJourneyPaymentMethodSchema = exports.zNexFinopsContractAsaasInfoSchema = exports.zNexFinopsAsaasSubscriptionStatusSchema = exports.zNexFinopsPaymentMethodSchema = exports.zNexFinopsProposalSchema = exports.zNexFinopsProposalWriteSchema = exports.zNexFinopsProposalPrefillSchema = exports.zNexFinopsProposalLoyaltyPeriodSchema = exports.zNexFinopsProposalPaymentMethodSchema = exports.zNexVendasContractTypeSchema = exports.zNexVendasAttributionSchema = exports.zNexFinopsProposalStatusSchema = exports.zServiceInvoiceSchema = exports.zServiceInvoiceReplacedBySchema = exports.zServiceInvoiceReissuedFromSchema = exports.zServiceInvoiceReissueSchema = exports.zNfseReissueStageSchema = exports.zNfseReissueFieldSchema = exports.zNfseReissueStatusSchema = exports.zServiceInvoiceCancellationSchema = exports.zNfseCancellationStatusSchema = exports.zPaymentLinkSchema = exports.zPaymentLinkDocumentStateSchema = exports.zAsaasPaymentLinkSubscriptionCycleSchema = exports.zAsaasPaymentLinkChargeTypeSchema = exports.zAsaasPaymentLinkBillingTypeSchema = exports.zProviderPayloadSnapshotSchema = exports.zProviderTraceSchema = exports.zProviderInvoiceErrorSchema = exports.zProviderInvoiceIdentifiersSchema = exports.zProviderInvoiceLinksSchema = void 0;
|
|
5
|
+
exports.zNexVendasOfferStartRequestSchema = exports.zNexVendasOfferWriteSchema = exports.zNexVendasAdhesionConfigWriteSchema = exports.zNexVendasContractTemplateAdhesionSchema = exports.zNexVendasAcceptanceRequestSchema = exports.zNfseFeeReimbursementExecuteSchema = exports.zNfseFeeReimbursementCompetenciaSchema = exports.zNexFinopsPaymentMethodsDiscoverSchema = exports.zNexFinopsBillingCardChargeSweepSchema = exports.zEvoBillingPortalCardCaptureSchema = exports.zNexFinopsBillingCardChargeSchema = exports.zNexFinopsContractPaymentMethodsWriteSchema = exports.zNexFinopsPaymentMethodPatchSchema = void 0;
|
|
6
6
|
const zod_1 = require("zod");
|
|
7
7
|
const zod_schemas_1 = require("../shared/zod-schemas");
|
|
8
8
|
// ---- Provider enums and base ----
|
|
@@ -822,6 +822,22 @@ exports.zNexFinopsProposalStatusSchema = zod_1.z.enum([
|
|
|
822
822
|
"expired",
|
|
823
823
|
"canceled",
|
|
824
824
|
]);
|
|
825
|
+
/** feat-326 — atribuição de marketing do `start` (`INexVendasAttribution`). */
|
|
826
|
+
exports.zNexVendasAttributionSchema = zod_1.z
|
|
827
|
+
.object({
|
|
828
|
+
utm_source: zod_1.z.string().max(255).optional().nullable(),
|
|
829
|
+
utm_medium: zod_1.z.string().max(255).optional().nullable(),
|
|
830
|
+
utm_campaign: zod_1.z.string().max(255).optional().nullable(),
|
|
831
|
+
utm_term: zod_1.z.string().max(255).optional().nullable(),
|
|
832
|
+
utm_content: zod_1.z.string().max(255).optional().nullable(),
|
|
833
|
+
gclid: zod_1.z.string().max(255).optional().nullable(),
|
|
834
|
+
referrer: zod_1.z.string().max(2048).optional().nullable(),
|
|
835
|
+
site: zod_1.z.string().max(64).optional().nullable(),
|
|
836
|
+
landing_path: zod_1.z.string().max(512).optional().nullable(),
|
|
837
|
+
})
|
|
838
|
+
.strip();
|
|
839
|
+
/** feat-325 — tipo de formalização do contrato (`NexVendasContractType`). */
|
|
840
|
+
exports.zNexVendasContractTypeSchema = zod_1.z.enum(["assinatura_eletronica", "adesao"]);
|
|
825
841
|
exports.zNexFinopsProposalPaymentMethodSchema = zod_1.z.enum([
|
|
826
842
|
"boleto",
|
|
827
843
|
"card_subscription",
|
|
@@ -874,6 +890,17 @@ exports.zNexFinopsProposalWriteSchema = zod_1.z
|
|
|
874
890
|
loyalty_period: exports.zNexFinopsProposalLoyaltyPeriodSchema.optional().nullable(),
|
|
875
891
|
/** Chave do modelo, nunca o id do template no provider — id não entra por HTTP. */
|
|
876
892
|
contract_template_key: zod_1.z.string().max(64).optional().nullable(),
|
|
893
|
+
/**
|
|
894
|
+
* feat-325 — derivado no backend do modelo escolhido (o valor do cliente HTTP é
|
|
895
|
+
* sobrescrito). Está no schema para o backend não perder o campo no `.strip()`.
|
|
896
|
+
*/
|
|
897
|
+
contract_type: exports.zNexVendasContractTypeSchema.optional().nullable(),
|
|
898
|
+
/** feat-326 — preenchidos pelo `start` da oferta; no CRUD do vendedor ficam ausentes. */
|
|
899
|
+
offer_slug: zod_1.z.string().max(64).optional().nullable(),
|
|
900
|
+
attribution: exports.zNexVendasAttributionSchema.optional().nullable(),
|
|
901
|
+
client_request_id: zod_1.z.string().max(64).optional().nullable(),
|
|
902
|
+
/** Resolvido no servidor (uid do token ou `system:offer`); o valor do cliente é sobrescrito. */
|
|
903
|
+
created_by: zod_1.z.string().max(128).optional().nullable(),
|
|
877
904
|
terms: zod_1.z.string().nullable().optional(),
|
|
878
905
|
valid_until: zod_1.z
|
|
879
906
|
.string()
|
|
@@ -1221,3 +1248,97 @@ exports.zNfseFeeReimbursementExecuteSchema = zod_1.z
|
|
|
1221
1248
|
}),
|
|
1222
1249
|
})
|
|
1223
1250
|
.strict();
|
|
1251
|
+
// ---- Nexus Vendas — contrato por adesão (feat-325) ----
|
|
1252
|
+
const zSha256HexSchema = zod_1.z.string().regex(/^[a-f0-9]{64}$/, "sha256 must be 64 lowercase hex chars");
|
|
1253
|
+
/**
|
|
1254
|
+
* Corpo de `POST /journeys/:short_code/contract/accept` (público). IP, user-agent,
|
|
1255
|
+
* idioma e trace vêm da requisição, nunca do corpo.
|
|
1256
|
+
*/
|
|
1257
|
+
exports.zNexVendasAcceptanceRequestSchema = zod_1.z
|
|
1258
|
+
.object({
|
|
1259
|
+
cg_sha256: zSha256HexSchema,
|
|
1260
|
+
summary_sha256: zSha256HexSchema,
|
|
1261
|
+
declaration_version: zod_1.z.string().min(1).max(64),
|
|
1262
|
+
viewed_to_end: zod_1.z.boolean(),
|
|
1263
|
+
client_request_id: zod_1.z.string().min(8).max(64),
|
|
1264
|
+
})
|
|
1265
|
+
.strip();
|
|
1266
|
+
/** Bloco `adhesion` do modelo de contrato (metadados das CG gravados pelo backend no upload). */
|
|
1267
|
+
exports.zNexVendasContractTemplateAdhesionSchema = zod_1.z
|
|
1268
|
+
.object({
|
|
1269
|
+
cg: zod_1.z
|
|
1270
|
+
.object({
|
|
1271
|
+
version: zod_1.z.string().min(1).max(64),
|
|
1272
|
+
sha256: zSha256HexSchema,
|
|
1273
|
+
storage_path: zod_1.z.string().min(1).max(512),
|
|
1274
|
+
effective_from: zod_1.z
|
|
1275
|
+
.string()
|
|
1276
|
+
.regex(/^\d{4}-\d{2}-\d{2}$/, "effective_from must be an ISO date (YYYY-MM-DD)"),
|
|
1277
|
+
filename: zod_1.z.string().min(1).max(255),
|
|
1278
|
+
})
|
|
1279
|
+
.strip(),
|
|
1280
|
+
require_email_otp: zod_1.z.boolean().optional().nullable(),
|
|
1281
|
+
})
|
|
1282
|
+
.strip();
|
|
1283
|
+
/** Doc `core/nexus/apps/nex-vendas/config/adhesion` (escrita pelo Nexus). */
|
|
1284
|
+
exports.zNexVendasAdhesionConfigWriteSchema = zod_1.z
|
|
1285
|
+
.object({
|
|
1286
|
+
declaration: zod_1.z
|
|
1287
|
+
.object({
|
|
1288
|
+
version: zod_1.z.string().min(1).max(64),
|
|
1289
|
+
text: zod_1.z.string().min(1).max(4000),
|
|
1290
|
+
})
|
|
1291
|
+
.strip(),
|
|
1292
|
+
document_access_days: zod_1.z.number().int().min(1).max(3650).optional().nullable(),
|
|
1293
|
+
corrections_per_hour: zod_1.z.number().int().min(1).max(100).optional().nullable(),
|
|
1294
|
+
})
|
|
1295
|
+
.strip();
|
|
1296
|
+
// ---- Nexus Vendas — ofertas self-service (feat-326) ----
|
|
1297
|
+
/**
|
|
1298
|
+
* Escrita da oferta `core/nexus/apps/nex-vendas/offers/{slug}` (Nexus → `nex_finops`).
|
|
1299
|
+
* Cobre TODOS os campos de `INexVendasOffer`: o que fica fora do `.strip()` some em
|
|
1300
|
+
* silêncio. `contract_type`, `created_by` e `start_count` são resolvidos no servidor
|
|
1301
|
+
* (o valor do cliente é sobrescrito) e estão aqui para o backend não perdê-los.
|
|
1302
|
+
* Regras de negócio (v1 só `card_subscription`, modelo ativo) ficam no use case.
|
|
1303
|
+
*/
|
|
1304
|
+
exports.zNexVendasOfferWriteSchema = zod_1.z
|
|
1305
|
+
.object({
|
|
1306
|
+
slug: zod_1.z
|
|
1307
|
+
.string()
|
|
1308
|
+
.min(2)
|
|
1309
|
+
.max(64)
|
|
1310
|
+
.regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, "slug must be kebab-case [a-z0-9-]"),
|
|
1311
|
+
name: zod_1.z.string().min(1).max(255),
|
|
1312
|
+
headline: zod_1.z.string().min(1).max(255),
|
|
1313
|
+
description: zod_1.z.string().max(4000).optional().nullable(),
|
|
1314
|
+
html_content: zod_1.z.string().optional().nullable(),
|
|
1315
|
+
base_amount: zod_1.z.number().nonnegative(),
|
|
1316
|
+
due_day: zod_1.z.number().int().min(1).max(31),
|
|
1317
|
+
accepted_payment_methods: zod_1.z.array(exports.zNexFinopsProposalPaymentMethodSchema).min(1),
|
|
1318
|
+
loyalty_period: exports.zNexFinopsProposalLoyaltyPeriodSchema,
|
|
1319
|
+
contract_template_key: zod_1.z.string().min(1).max(64),
|
|
1320
|
+
contract_type: exports.zNexVendasContractTypeSchema.optional().nullable(),
|
|
1321
|
+
allowances: exports.zNexFinopsContractAllowancesSchema.nullable(),
|
|
1322
|
+
terms: zod_1.z.string().optional().nullable(),
|
|
1323
|
+
proposal_valid_days: zod_1.z.number().int().min(1).max(90),
|
|
1324
|
+
site: zod_1.z.string().min(1).max(64),
|
|
1325
|
+
origem: zod_1.z.string().min(1).max(64).optional().nullable(),
|
|
1326
|
+
active: zod_1.z.boolean(),
|
|
1327
|
+
listed: zod_1.z.boolean(),
|
|
1328
|
+
created_by: zod_1.z.string().max(128).optional(),
|
|
1329
|
+
start_count: zod_1.z.number().int().nonnegative().optional().nullable(),
|
|
1330
|
+
last_start_at: zod_schemas_1.zFirestoreDateSchema.optional().nullable(),
|
|
1331
|
+
})
|
|
1332
|
+
.strip();
|
|
1333
|
+
/** Corpo de `POST /offers/:slug/start` (público). */
|
|
1334
|
+
exports.zNexVendasOfferStartRequestSchema = zod_1.z
|
|
1335
|
+
.object({
|
|
1336
|
+
name: zod_1.z.string().trim().min(2).max(255),
|
|
1337
|
+
email: zod_1.z.string().trim().email().max(255),
|
|
1338
|
+
phone: zod_1.z.string().trim().min(8).max(32),
|
|
1339
|
+
client_request_id: zod_1.z.string().min(8).max(64),
|
|
1340
|
+
turnstile_token: zod_1.z.string().min(1).max(4096),
|
|
1341
|
+
attribution: exports.zNexVendasAttributionSchema.optional().nullable(),
|
|
1342
|
+
privacy_accepted: zod_1.z.literal(true),
|
|
1343
|
+
})
|
|
1344
|
+
.strip();
|
|
@@ -898,6 +898,24 @@ export const zNexFinopsProposalStatusSchema = z.enum([
|
|
|
898
898
|
"canceled",
|
|
899
899
|
]);
|
|
900
900
|
|
|
901
|
+
/** feat-326 — atribuição de marketing do `start` (`INexVendasAttribution`). */
|
|
902
|
+
export const zNexVendasAttributionSchema = z
|
|
903
|
+
.object({
|
|
904
|
+
utm_source: z.string().max(255).optional().nullable(),
|
|
905
|
+
utm_medium: z.string().max(255).optional().nullable(),
|
|
906
|
+
utm_campaign: z.string().max(255).optional().nullable(),
|
|
907
|
+
utm_term: z.string().max(255).optional().nullable(),
|
|
908
|
+
utm_content: z.string().max(255).optional().nullable(),
|
|
909
|
+
gclid: z.string().max(255).optional().nullable(),
|
|
910
|
+
referrer: z.string().max(2048).optional().nullable(),
|
|
911
|
+
site: z.string().max(64).optional().nullable(),
|
|
912
|
+
landing_path: z.string().max(512).optional().nullable(),
|
|
913
|
+
})
|
|
914
|
+
.strip();
|
|
915
|
+
|
|
916
|
+
/** feat-325 — tipo de formalização do contrato (`NexVendasContractType`). */
|
|
917
|
+
export const zNexVendasContractTypeSchema = z.enum(["assinatura_eletronica", "adesao"]);
|
|
918
|
+
|
|
901
919
|
export const zNexFinopsProposalPaymentMethodSchema = z.enum([
|
|
902
920
|
"boleto",
|
|
903
921
|
"card_subscription",
|
|
@@ -953,6 +971,17 @@ export const zNexFinopsProposalWriteSchema = z
|
|
|
953
971
|
loyalty_period: zNexFinopsProposalLoyaltyPeriodSchema.optional().nullable(),
|
|
954
972
|
/** Chave do modelo, nunca o id do template no provider — id não entra por HTTP. */
|
|
955
973
|
contract_template_key: z.string().max(64).optional().nullable(),
|
|
974
|
+
/**
|
|
975
|
+
* feat-325 — derivado no backend do modelo escolhido (o valor do cliente HTTP é
|
|
976
|
+
* sobrescrito). Está no schema para o backend não perder o campo no `.strip()`.
|
|
977
|
+
*/
|
|
978
|
+
contract_type: zNexVendasContractTypeSchema.optional().nullable(),
|
|
979
|
+
/** feat-326 — preenchidos pelo `start` da oferta; no CRUD do vendedor ficam ausentes. */
|
|
980
|
+
offer_slug: z.string().max(64).optional().nullable(),
|
|
981
|
+
attribution: zNexVendasAttributionSchema.optional().nullable(),
|
|
982
|
+
client_request_id: z.string().max(64).optional().nullable(),
|
|
983
|
+
/** Resolvido no servidor (uid do token ou `system:offer`); o valor do cliente é sobrescrito. */
|
|
984
|
+
created_by: z.string().max(128).optional().nullable(),
|
|
956
985
|
terms: z.string().nullable().optional(),
|
|
957
986
|
valid_until: z
|
|
958
987
|
.string()
|
|
@@ -1344,3 +1373,105 @@ export const zNfseFeeReimbursementExecuteSchema = z
|
|
|
1344
1373
|
}),
|
|
1345
1374
|
})
|
|
1346
1375
|
.strict();
|
|
1376
|
+
|
|
1377
|
+
// ---- Nexus Vendas — contrato por adesão (feat-325) ----
|
|
1378
|
+
|
|
1379
|
+
const zSha256HexSchema = z.string().regex(/^[a-f0-9]{64}$/, "sha256 must be 64 lowercase hex chars");
|
|
1380
|
+
|
|
1381
|
+
/**
|
|
1382
|
+
* Corpo de `POST /journeys/:short_code/contract/accept` (público). IP, user-agent,
|
|
1383
|
+
* idioma e trace vêm da requisição, nunca do corpo.
|
|
1384
|
+
*/
|
|
1385
|
+
export const zNexVendasAcceptanceRequestSchema = z
|
|
1386
|
+
.object({
|
|
1387
|
+
cg_sha256: zSha256HexSchema,
|
|
1388
|
+
summary_sha256: zSha256HexSchema,
|
|
1389
|
+
declaration_version: z.string().min(1).max(64),
|
|
1390
|
+
viewed_to_end: z.boolean(),
|
|
1391
|
+
client_request_id: z.string().min(8).max(64),
|
|
1392
|
+
})
|
|
1393
|
+
.strip();
|
|
1394
|
+
|
|
1395
|
+
/** Bloco `adhesion` do modelo de contrato (metadados das CG gravados pelo backend no upload). */
|
|
1396
|
+
export const zNexVendasContractTemplateAdhesionSchema = z
|
|
1397
|
+
.object({
|
|
1398
|
+
cg: z
|
|
1399
|
+
.object({
|
|
1400
|
+
version: z.string().min(1).max(64),
|
|
1401
|
+
sha256: zSha256HexSchema,
|
|
1402
|
+
storage_path: z.string().min(1).max(512),
|
|
1403
|
+
effective_from: z
|
|
1404
|
+
.string()
|
|
1405
|
+
.regex(/^\d{4}-\d{2}-\d{2}$/, "effective_from must be an ISO date (YYYY-MM-DD)"),
|
|
1406
|
+
filename: z.string().min(1).max(255),
|
|
1407
|
+
})
|
|
1408
|
+
.strip(),
|
|
1409
|
+
require_email_otp: z.boolean().optional().nullable(),
|
|
1410
|
+
})
|
|
1411
|
+
.strip();
|
|
1412
|
+
|
|
1413
|
+
/** Doc `core/nexus/apps/nex-vendas/config/adhesion` (escrita pelo Nexus). */
|
|
1414
|
+
export const zNexVendasAdhesionConfigWriteSchema = z
|
|
1415
|
+
.object({
|
|
1416
|
+
declaration: z
|
|
1417
|
+
.object({
|
|
1418
|
+
version: z.string().min(1).max(64),
|
|
1419
|
+
text: z.string().min(1).max(4000),
|
|
1420
|
+
})
|
|
1421
|
+
.strip(),
|
|
1422
|
+
document_access_days: z.number().int().min(1).max(3650).optional().nullable(),
|
|
1423
|
+
corrections_per_hour: z.number().int().min(1).max(100).optional().nullable(),
|
|
1424
|
+
})
|
|
1425
|
+
.strip();
|
|
1426
|
+
|
|
1427
|
+
// ---- Nexus Vendas — ofertas self-service (feat-326) ----
|
|
1428
|
+
|
|
1429
|
+
/**
|
|
1430
|
+
* Escrita da oferta `core/nexus/apps/nex-vendas/offers/{slug}` (Nexus → `nex_finops`).
|
|
1431
|
+
* Cobre TODOS os campos de `INexVendasOffer`: o que fica fora do `.strip()` some em
|
|
1432
|
+
* silêncio. `contract_type`, `created_by` e `start_count` são resolvidos no servidor
|
|
1433
|
+
* (o valor do cliente é sobrescrito) e estão aqui para o backend não perdê-los.
|
|
1434
|
+
* Regras de negócio (v1 só `card_subscription`, modelo ativo) ficam no use case.
|
|
1435
|
+
*/
|
|
1436
|
+
export const zNexVendasOfferWriteSchema = z
|
|
1437
|
+
.object({
|
|
1438
|
+
slug: z
|
|
1439
|
+
.string()
|
|
1440
|
+
.min(2)
|
|
1441
|
+
.max(64)
|
|
1442
|
+
.regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, "slug must be kebab-case [a-z0-9-]"),
|
|
1443
|
+
name: z.string().min(1).max(255),
|
|
1444
|
+
headline: z.string().min(1).max(255),
|
|
1445
|
+
description: z.string().max(4000).optional().nullable(),
|
|
1446
|
+
html_content: z.string().optional().nullable(),
|
|
1447
|
+
base_amount: z.number().nonnegative(),
|
|
1448
|
+
due_day: z.number().int().min(1).max(31),
|
|
1449
|
+
accepted_payment_methods: z.array(zNexFinopsProposalPaymentMethodSchema).min(1),
|
|
1450
|
+
loyalty_period: zNexFinopsProposalLoyaltyPeriodSchema,
|
|
1451
|
+
contract_template_key: z.string().min(1).max(64),
|
|
1452
|
+
contract_type: zNexVendasContractTypeSchema.optional().nullable(),
|
|
1453
|
+
allowances: zNexFinopsContractAllowancesSchema.nullable(),
|
|
1454
|
+
terms: z.string().optional().nullable(),
|
|
1455
|
+
proposal_valid_days: z.number().int().min(1).max(90),
|
|
1456
|
+
site: z.string().min(1).max(64),
|
|
1457
|
+
origem: z.string().min(1).max(64).optional().nullable(),
|
|
1458
|
+
active: z.boolean(),
|
|
1459
|
+
listed: z.boolean(),
|
|
1460
|
+
created_by: z.string().max(128).optional(),
|
|
1461
|
+
start_count: z.number().int().nonnegative().optional().nullable(),
|
|
1462
|
+
last_start_at: zFirestoreDateSchema.optional().nullable(),
|
|
1463
|
+
})
|
|
1464
|
+
.strip();
|
|
1465
|
+
|
|
1466
|
+
/** Corpo de `POST /offers/:slug/start` (público). */
|
|
1467
|
+
export const zNexVendasOfferStartRequestSchema = z
|
|
1468
|
+
.object({
|
|
1469
|
+
name: z.string().trim().min(2).max(255),
|
|
1470
|
+
email: z.string().trim().email().max(255),
|
|
1471
|
+
phone: z.string().trim().min(8).max(32),
|
|
1472
|
+
client_request_id: z.string().min(8).max(64),
|
|
1473
|
+
turnstile_token: z.string().min(1).max(4096),
|
|
1474
|
+
attribution: zNexVendasAttributionSchema.optional().nullable(),
|
|
1475
|
+
privacy_accepted: z.literal(true),
|
|
1476
|
+
})
|
|
1477
|
+
.strip();
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* feat-328 F2 — extrato do Billing de uma competência e o snapshot de preço.
|
|
3
|
+
*
|
|
4
|
+
* O extrato é o "racional" linha a linha do valor de um tenant num mês. É calculado
|
|
5
|
+
* pelo motor do backend (`@evo/nex-model`, `computeBillingStatement`) e congelado
|
|
6
|
+
* na cobrança em `usage_snapshot`, junto com `pricing_snapshot` (a tabela resolvida
|
|
7
|
+
* que o produziu). Com os dois, a cobrança se explica sozinha, mesmo que o consumo,
|
|
8
|
+
* o contrato ou a tabela mudem depois.
|
|
9
|
+
*
|
|
10
|
+
* Schema 1 (`ssr_excess_or_table_v1`) = extratos congelados pelo front do Nexus até
|
|
11
|
+
* out/2026, com preço fixo no código. Schema 2 (`price_table_v1`) = motor do
|
|
12
|
+
* backend lendo a tabela de preço. Os campos comuns têm o MESMO nome e significado
|
|
13
|
+
* nos dois — o front lê os dois sem migração.
|
|
14
|
+
*/
|
|
15
|
+
import type { ResolvedPriceLine } from './price-table';
|
|
16
|
+
/** Modo de cobrança do contrato (Q13/Q17). Ausente = `standard`. */
|
|
17
|
+
export type NexFinopsBillingMode = 'standard' | 'trial';
|
|
18
|
+
export declare const BILLING_STATEMENT_SCHEMA = 2;
|
|
19
|
+
export declare const BILLING_STATEMENT_FORMULA = "price_table_v1";
|
|
20
|
+
export interface IBillingStatementLine {
|
|
21
|
+
/**
|
|
22
|
+
* Chave aberta: métrica do catálogo (`attendances`, `sms`…), módulo (`recurring`)
|
|
23
|
+
* ou `extra:<CAT>` para serviço fixo do contrato.
|
|
24
|
+
*/
|
|
25
|
+
key: string;
|
|
26
|
+
label: string;
|
|
27
|
+
/** `usage` = consumo × franquia; `fixed` = serviço fixo do contrato; `recurring` = módulo ativo. */
|
|
28
|
+
kind: 'usage' | 'fixed' | 'recurring';
|
|
29
|
+
/** Categoria do item na cobrança (`services[].category`) que este valor compõe. */
|
|
30
|
+
billing_category: string;
|
|
31
|
+
/** Descrição sugerida para o item na cobrança. */
|
|
32
|
+
billing_description: string;
|
|
33
|
+
/** `null` = série indisponível no mês (≠ zero). */
|
|
34
|
+
used?: number | null;
|
|
35
|
+
/** `null` = métrica sem franquia nos contratos (não cobrada). */
|
|
36
|
+
included?: number | null;
|
|
37
|
+
excess?: number;
|
|
38
|
+
unit_price?: number | null;
|
|
39
|
+
amount: number;
|
|
40
|
+
/** Tabela da cadeia que declarou o preço da linha (schema 2). `null` em `fixed`. */
|
|
41
|
+
source?: {
|
|
42
|
+
table_id: string;
|
|
43
|
+
} | null;
|
|
44
|
+
/** Contrato de origem da linha `fixed` (schema 2). */
|
|
45
|
+
contract_id?: string | null;
|
|
46
|
+
}
|
|
47
|
+
export interface IBillingStatement {
|
|
48
|
+
schema: number;
|
|
49
|
+
formula: string;
|
|
50
|
+
/** `YYYY-MM`. */
|
|
51
|
+
competency: string;
|
|
52
|
+
currency: 'BRL';
|
|
53
|
+
tenant: string | null;
|
|
54
|
+
/** Contratos vigentes que compõem o extrato (schema 2). */
|
|
55
|
+
contract_ids?: string[];
|
|
56
|
+
/** Schema 2. Ausente (schema 1) = `standard`. */
|
|
57
|
+
billing_mode?: NexFinopsBillingMode;
|
|
58
|
+
/** Base dos atendimentos: soma do SSR dos contratos. */
|
|
59
|
+
ssr_base: number;
|
|
60
|
+
/** Por que o valor de atendimentos é o que é. */
|
|
61
|
+
attendances: {
|
|
62
|
+
rule: 'base' | 'excess' | 'table';
|
|
63
|
+
with_excess: number | null;
|
|
64
|
+
table_value: number | null;
|
|
65
|
+
table_tier: number | null;
|
|
66
|
+
};
|
|
67
|
+
lines: IBillingStatementLine[];
|
|
68
|
+
/** Valor calculado. Em `trial` é 0 (o extrato mostra o que seria cobrado nas linhas). */
|
|
69
|
+
total: number;
|
|
70
|
+
/** Schema 2. `false` em `trial`: o extrato existe, a cobrança não. */
|
|
71
|
+
charged?: boolean;
|
|
72
|
+
/** Origem dos números de consumo. */
|
|
73
|
+
usage_source: string;
|
|
74
|
+
/**
|
|
75
|
+
* Schema 2. `false` = o mês está fora da janela da série de consumo (12 meses).
|
|
76
|
+
* ⚠️ NÃO detecta ingestão falha: a série preenche com zero todo mês da janela, então
|
|
77
|
+
* mês com ingestão incompleta sai `true` com consumo baixo. O gate de ingestão é da feat-252.
|
|
78
|
+
*/
|
|
79
|
+
usage_available?: boolean;
|
|
80
|
+
/** Schema 2. Métricas com consumo e sem franquia: não cobradas, só sinalizadas. */
|
|
81
|
+
used_without_allowance?: string[];
|
|
82
|
+
/** Schema 2. Métricas com franquia e excedente mas sem linha de preço (ou `disabled`). */
|
|
83
|
+
used_without_price?: string[];
|
|
84
|
+
/** Preenchidos só no congelamento. */
|
|
85
|
+
captured_at?: string;
|
|
86
|
+
captured_by?: string | null;
|
|
87
|
+
}
|
|
88
|
+
/** Tabela de preço resolvida que produziu o extrato, congelada na cobrança. */
|
|
89
|
+
export interface INexFinopsBillingPricingSnapshot {
|
|
90
|
+
/** Da tabela do contrato até a padrão, inclusive. */
|
|
91
|
+
table_chain: string[];
|
|
92
|
+
lines: Record<string, ResolvedPriceLine>;
|
|
93
|
+
/** Módulos considerados para linhas `recurring` (ativos no fechamento, `trial` fora — Q5). */
|
|
94
|
+
modules_active: string[];
|
|
95
|
+
billing_mode: NexFinopsBillingMode;
|
|
96
|
+
resolved_at: string;
|
|
97
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* feat-328 F2 — extrato do Billing de uma competência e o snapshot de preço.
|
|
4
|
+
*
|
|
5
|
+
* O extrato é o "racional" linha a linha do valor de um tenant num mês. É calculado
|
|
6
|
+
* pelo motor do backend (`@evo/nex-model`, `computeBillingStatement`) e congelado
|
|
7
|
+
* na cobrança em `usage_snapshot`, junto com `pricing_snapshot` (a tabela resolvida
|
|
8
|
+
* que o produziu). Com os dois, a cobrança se explica sozinha, mesmo que o consumo,
|
|
9
|
+
* o contrato ou a tabela mudem depois.
|
|
10
|
+
*
|
|
11
|
+
* Schema 1 (`ssr_excess_or_table_v1`) = extratos congelados pelo front do Nexus até
|
|
12
|
+
* out/2026, com preço fixo no código. Schema 2 (`price_table_v1`) = motor do
|
|
13
|
+
* backend lendo a tabela de preço. Os campos comuns têm o MESMO nome e significado
|
|
14
|
+
* nos dois — o front lê os dois sem migração.
|
|
15
|
+
*/
|
|
16
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
17
|
+
exports.BILLING_STATEMENT_FORMULA = exports.BILLING_STATEMENT_SCHEMA = void 0;
|
|
18
|
+
exports.BILLING_STATEMENT_SCHEMA = 2;
|
|
19
|
+
exports.BILLING_STATEMENT_FORMULA = 'price_table_v1';
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* feat-328 F2 — extrato do Billing de uma competência e o snapshot de preço.
|
|
3
|
+
*
|
|
4
|
+
* O extrato é o "racional" linha a linha do valor de um tenant num mês. É calculado
|
|
5
|
+
* pelo motor do backend (`@evo/nex-model`, `computeBillingStatement`) e congelado
|
|
6
|
+
* na cobrança em `usage_snapshot`, junto com `pricing_snapshot` (a tabela resolvida
|
|
7
|
+
* que o produziu). Com os dois, a cobrança se explica sozinha, mesmo que o consumo,
|
|
8
|
+
* o contrato ou a tabela mudem depois.
|
|
9
|
+
*
|
|
10
|
+
* Schema 1 (`ssr_excess_or_table_v1`) = extratos congelados pelo front do Nexus até
|
|
11
|
+
* out/2026, com preço fixo no código. Schema 2 (`price_table_v1`) = motor do
|
|
12
|
+
* backend lendo a tabela de preço. Os campos comuns têm o MESMO nome e significado
|
|
13
|
+
* nos dois — o front lê os dois sem migração.
|
|
14
|
+
*/
|
|
15
|
+
|
|
16
|
+
import type { ResolvedPriceLine } from './price-table';
|
|
17
|
+
|
|
18
|
+
/** Modo de cobrança do contrato (Q13/Q17). Ausente = `standard`. */
|
|
19
|
+
export type NexFinopsBillingMode = 'standard' | 'trial';
|
|
20
|
+
|
|
21
|
+
export const BILLING_STATEMENT_SCHEMA = 2;
|
|
22
|
+
export const BILLING_STATEMENT_FORMULA = 'price_table_v1';
|
|
23
|
+
|
|
24
|
+
export interface IBillingStatementLine {
|
|
25
|
+
/**
|
|
26
|
+
* Chave aberta: métrica do catálogo (`attendances`, `sms`…), módulo (`recurring`)
|
|
27
|
+
* ou `extra:<CAT>` para serviço fixo do contrato.
|
|
28
|
+
*/
|
|
29
|
+
key: string;
|
|
30
|
+
label: string;
|
|
31
|
+
/** `usage` = consumo × franquia; `fixed` = serviço fixo do contrato; `recurring` = módulo ativo. */
|
|
32
|
+
kind: 'usage' | 'fixed' | 'recurring';
|
|
33
|
+
/** Categoria do item na cobrança (`services[].category`) que este valor compõe. */
|
|
34
|
+
billing_category: string;
|
|
35
|
+
/** Descrição sugerida para o item na cobrança. */
|
|
36
|
+
billing_description: string;
|
|
37
|
+
/** `null` = série indisponível no mês (≠ zero). */
|
|
38
|
+
used?: number | null;
|
|
39
|
+
/** `null` = métrica sem franquia nos contratos (não cobrada). */
|
|
40
|
+
included?: number | null;
|
|
41
|
+
excess?: number;
|
|
42
|
+
unit_price?: number | null;
|
|
43
|
+
amount: number;
|
|
44
|
+
/** Tabela da cadeia que declarou o preço da linha (schema 2). `null` em `fixed`. */
|
|
45
|
+
source?: { table_id: string } | null;
|
|
46
|
+
/** Contrato de origem da linha `fixed` (schema 2). */
|
|
47
|
+
contract_id?: string | null;
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
export interface IBillingStatement {
|
|
51
|
+
schema: number;
|
|
52
|
+
formula: string;
|
|
53
|
+
/** `YYYY-MM`. */
|
|
54
|
+
competency: string;
|
|
55
|
+
currency: 'BRL';
|
|
56
|
+
tenant: string | null;
|
|
57
|
+
/** Contratos vigentes que compõem o extrato (schema 2). */
|
|
58
|
+
contract_ids?: string[];
|
|
59
|
+
/** Schema 2. Ausente (schema 1) = `standard`. */
|
|
60
|
+
billing_mode?: NexFinopsBillingMode;
|
|
61
|
+
/** Base dos atendimentos: soma do SSR dos contratos. */
|
|
62
|
+
ssr_base: number;
|
|
63
|
+
/** Por que o valor de atendimentos é o que é. */
|
|
64
|
+
attendances: {
|
|
65
|
+
rule: 'base' | 'excess' | 'table';
|
|
66
|
+
with_excess: number | null;
|
|
67
|
+
table_value: number | null;
|
|
68
|
+
table_tier: number | null;
|
|
69
|
+
};
|
|
70
|
+
lines: IBillingStatementLine[];
|
|
71
|
+
/** Valor calculado. Em `trial` é 0 (o extrato mostra o que seria cobrado nas linhas). */
|
|
72
|
+
total: number;
|
|
73
|
+
/** Schema 2. `false` em `trial`: o extrato existe, a cobrança não. */
|
|
74
|
+
charged?: boolean;
|
|
75
|
+
/** Origem dos números de consumo. */
|
|
76
|
+
usage_source: string;
|
|
77
|
+
/**
|
|
78
|
+
* Schema 2. `false` = o mês está fora da janela da série de consumo (12 meses).
|
|
79
|
+
* ⚠️ NÃO detecta ingestão falha: a série preenche com zero todo mês da janela, então
|
|
80
|
+
* mês com ingestão incompleta sai `true` com consumo baixo. O gate de ingestão é da feat-252.
|
|
81
|
+
*/
|
|
82
|
+
usage_available?: boolean;
|
|
83
|
+
/** Schema 2. Métricas com consumo e sem franquia: não cobradas, só sinalizadas. */
|
|
84
|
+
used_without_allowance?: string[];
|
|
85
|
+
/** Schema 2. Métricas com franquia e excedente mas sem linha de preço (ou `disabled`). */
|
|
86
|
+
used_without_price?: string[];
|
|
87
|
+
/** Preenchidos só no congelamento. */
|
|
88
|
+
captured_at?: string;
|
|
89
|
+
captured_by?: string | null;
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
/** Tabela de preço resolvida que produziu o extrato, congelada na cobrança. */
|
|
93
|
+
export interface INexFinopsBillingPricingSnapshot {
|
|
94
|
+
/** Da tabela do contrato até a padrão, inclusive. */
|
|
95
|
+
table_chain: string[];
|
|
96
|
+
lines: Record<string, ResolvedPriceLine>;
|
|
97
|
+
/** Módulos considerados para linhas `recurring` (ativos no fechamento, `trial` fora — Q5). */
|
|
98
|
+
modules_active: string[];
|
|
99
|
+
billing_mode: NexFinopsBillingMode;
|
|
100
|
+
resolved_at: string;
|
|
101
|
+
}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import type { IFireGlobalDoc } from '../../shared';
|
|
2
2
|
import type { NexFinopsPaymentMethodKind } from './payment-method';
|
|
3
|
+
import type { IBillingStatement, INexFinopsBillingPricingSnapshot } from './billing-statement';
|
|
3
4
|
export type NexFinopsBillingStatus = 'draft' | 'issued' | 'paid' | 'overdue' | 'canceled';
|
|
4
5
|
export type NexFinopsBillingAttachmentCategory = 'boleto' | 'invoice' | 'other';
|
|
5
6
|
export interface INexFinopsBillingServiceItem {
|
|
@@ -201,6 +202,14 @@ export interface INexFinopsBilling extends IFireGlobalDoc {
|
|
|
201
202
|
competency?: INexFinopsBillingCompetency | null;
|
|
202
203
|
contract_snapshot?: Record<string, unknown> | null;
|
|
203
204
|
customer_snapshot?: Record<string, unknown> | null;
|
|
205
|
+
/**
|
|
206
|
+
* Extrato da competência congelado na cobrança. Schema 1 = gravado pelo front do
|
|
207
|
+
* Nexus até out/2026 (lido como está); schema 2 = motor do backend. Só o backend
|
|
208
|
+
* grava schema 2 (`POST /billings/:id/freeze-statement` ou `generate` com `from_statement`).
|
|
209
|
+
*/
|
|
210
|
+
usage_snapshot?: IBillingStatement | null;
|
|
211
|
+
/** Tabela de preço resolvida que produziu o `usage_snapshot` schema 2. */
|
|
212
|
+
pricing_snapshot?: INexFinopsBillingPricingSnapshot | null;
|
|
204
213
|
notes?: string | null;
|
|
205
214
|
/** Método herdado do `default_payment_method_id` do contrato na geração (ou escolhido depois). */
|
|
206
215
|
payment_method_id?: string | null;
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import type { IFireGlobalDoc } from '../../shared';
|
|
2
2
|
import type { NexFinopsPaymentMethodKind } from './payment-method';
|
|
3
|
+
import type { IBillingStatement, INexFinopsBillingPricingSnapshot } from './billing-statement';
|
|
3
4
|
|
|
4
5
|
// ── Status ──
|
|
5
6
|
|
|
@@ -263,6 +264,17 @@ export interface INexFinopsBilling extends IFireGlobalDoc {
|
|
|
263
264
|
// Snapshot do cliente no momento da geração (dados para NF)
|
|
264
265
|
customer_snapshot?: Record<string, unknown> | null;
|
|
265
266
|
|
|
267
|
+
// ── Extrato congelado (feat-252 D2 / feat-328 F2) ──
|
|
268
|
+
|
|
269
|
+
/**
|
|
270
|
+
* Extrato da competência congelado na cobrança. Schema 1 = gravado pelo front do
|
|
271
|
+
* Nexus até out/2026 (lido como está); schema 2 = motor do backend. Só o backend
|
|
272
|
+
* grava schema 2 (`POST /billings/:id/freeze-statement` ou `generate` com `from_statement`).
|
|
273
|
+
*/
|
|
274
|
+
usage_snapshot?: IBillingStatement | null;
|
|
275
|
+
/** Tabela de preço resolvida que produziu o `usage_snapshot` schema 2. */
|
|
276
|
+
pricing_snapshot?: INexFinopsBillingPricingSnapshot | null;
|
|
277
|
+
|
|
266
278
|
// Observações
|
|
267
279
|
notes?: string | null;
|
|
268
280
|
|
|
@@ -1,4 +1,6 @@
|
|
|
1
|
+
import type { NexFinopsBillingMode } from './billing-statement';
|
|
1
2
|
import type { IFireGlobalDoc } from '../../shared';
|
|
3
|
+
import type { NexVendasContractType } from '../../nex-vendas/adhesion';
|
|
2
4
|
/**
|
|
3
5
|
* `cancellation_requested`: o cliente pediu o cancelamento e o contrato está em
|
|
4
6
|
* processo de encerramento — mas **continua em vigência** e continua faturando
|
|
@@ -148,6 +150,13 @@ export interface INexFinopsContract extends IFireGlobalDoc {
|
|
|
148
150
|
* nasce com direito a estorno; venda assistida, não. Default `false`.
|
|
149
151
|
*/
|
|
150
152
|
refund_eligible?: boolean | null;
|
|
153
|
+
/**
|
|
154
|
+
* feat-325 D2 — cópia do tipo de formalização da jornada (gravada no draft pelo
|
|
155
|
+
* `ensureContract`). Ausente = `assinatura_eletronica`.
|
|
156
|
+
*/
|
|
157
|
+
contract_type?: NexVendasContractType | null;
|
|
158
|
+
/** feat-325 — id do registro em `nex-vendas/acceptances/` (só adesão, após o aceite). */
|
|
159
|
+
acceptance_id?: string | null;
|
|
151
160
|
/** Método com que o primeiro pagamento foi feito. `accepted_payment_methods` é a oferta; este é o fato. */
|
|
152
161
|
payment_method?: NexFinopsPaymentMethod | null;
|
|
153
162
|
asaas?: INexFinopsContractAsaasInfo | null;
|
|
@@ -201,6 +210,12 @@ export interface INexFinopsContract extends IFireGlobalDoc {
|
|
|
201
210
|
* tabela (efetiva) — validado pelo backend ao ativar o contrato.
|
|
202
211
|
*/
|
|
203
212
|
price_table_id?: string | null;
|
|
213
|
+
/**
|
|
214
|
+
* feat-328 Q13/Q17 — modo de cobrança. ⚠️ Ausente = `standard`.
|
|
215
|
+
* `trial`: o fechamento calcula o extrato e NÃO gera cobrança. Exige `ends_at`
|
|
216
|
+
* (validação de escrita entra na F5; até lá o campo só é lido).
|
|
217
|
+
*/
|
|
218
|
+
billing_mode?: NexFinopsBillingMode;
|
|
204
219
|
}
|
|
205
220
|
export declare const NEX_FINOPS_CONTRACT_STATUS_TRANSITIONS: Record<NexFinopsContractStatus, NexFinopsContractStatus[]>;
|
|
206
221
|
/**
|
|
@@ -1,4 +1,6 @@
|
|
|
1
|
+
import type { NexFinopsBillingMode } from './billing-statement';
|
|
1
2
|
import type { IFireGlobalDoc } from '../../shared';
|
|
3
|
+
import type { NexVendasContractType } from '../../nex-vendas/adhesion';
|
|
2
4
|
|
|
3
5
|
// ── Status & Recurrence ──
|
|
4
6
|
|
|
@@ -176,6 +178,13 @@ export interface INexFinopsContract extends IFireGlobalDoc {
|
|
|
176
178
|
* nasce com direito a estorno; venda assistida, não. Default `false`.
|
|
177
179
|
*/
|
|
178
180
|
refund_eligible?: boolean | null;
|
|
181
|
+
/**
|
|
182
|
+
* feat-325 D2 — cópia do tipo de formalização da jornada (gravada no draft pelo
|
|
183
|
+
* `ensureContract`). Ausente = `assinatura_eletronica`.
|
|
184
|
+
*/
|
|
185
|
+
contract_type?: NexVendasContractType | null;
|
|
186
|
+
/** feat-325 — id do registro em `nex-vendas/acceptances/` (só adesão, após o aceite). */
|
|
187
|
+
acceptance_id?: string | null;
|
|
179
188
|
|
|
180
189
|
// ── Pagamento efetivo (feat-131) ──
|
|
181
190
|
|
|
@@ -244,6 +253,13 @@ export interface INexFinopsContract extends IFireGlobalDoc {
|
|
|
244
253
|
* tabela (efetiva) — validado pelo backend ao ativar o contrato.
|
|
245
254
|
*/
|
|
246
255
|
price_table_id?: string | null;
|
|
256
|
+
|
|
257
|
+
/**
|
|
258
|
+
* feat-328 Q13/Q17 — modo de cobrança. ⚠️ Ausente = `standard`.
|
|
259
|
+
* `trial`: o fechamento calcula o extrato e NÃO gera cobrança. Exige `ends_at`
|
|
260
|
+
* (validação de escrita entra na F5; até lá o campo só é lido).
|
|
261
|
+
*/
|
|
262
|
+
billing_mode?: NexFinopsBillingMode;
|
|
247
263
|
}
|
|
248
264
|
|
|
249
265
|
// ── Status transitions ──
|