@magnetcustomer/sdk 1.0.0 → 2.0.0

package/dist/generated/api/deals-api.d.ts

@@ -0,0 +1,546 @@
+/**
+ * API da Magnet Customer
+ * A API REST da Magnet Customer permite ler e gravar os registros do CRM a partir dos seus sistemas.  # Comece aqui  ## 1. Crie um Service Account  No CRM, abra **Configurações › Service Accounts** (apenas administradores), clique em **Novo service account**, escolha a validade e as permissões, e copie o **Client ID** e o **Client Secret**. O secret aparece uma única vez.  ## 2. Solicite um token  ```bash curl -X POST https://magnetcustomer.net/realms/platform/protocol/openid-connect/token \\   -H \"Content-Type: application/x-www-form-urlencoded\" \\   -d \"grant_type=client_credentials\" \\   -d \"client_id=SEU_CLIENT_ID\" \\   -d \"client_secret=SEU_CLIENT_SECRET\" ```  ```json { \"access_token\": \"eyJhbGciOiJSUzI1NiIs...\", \"expires_in\": 900, \"token_type\": \"Bearer\" } ```  O token vale 15 minutos e este fluxo não tem refresh token: quando vencer, ou ao receber `401`, repita o pedido.  ## 3. Chame a API  Cada conta tem o seu endereço. Troque `sua-conta` pelo subdomínio que você usa para abrir o CRM:  ```bash curl \"https://sua-conta.platform-api.magnetcustomer.com/api/deals?page=1&limit=15\" \\   -H \"Authorization: Bearer SEU_TOKEN\" ```  Requisições com corpo levam também `Content-Type: application/json`.  # Convenções  ## Paginação  Envie sempre `page`. Com ele, toda listagem devolve o mesmo envelope:  ```json { \"docs\": [], \"total\": 132, \"pages\": 9, \"page\": 1, \"limit\": 15 } ```  | Parâmetro | Padrão | Descrição | |---|---|---| | `page` | — | Página, a partir de 1. **Obrigatório na prática** | | `limit` | 15 | Registros por página. Máximo 100: acima disso a API usa 100 | | `sortBy` | varia por recurso | Campo de ordenação | | `sortType` | `desc` | `asc` ou `desc` | | `search` | — | Busca textual, quando o recurso aceita |  Sem `page`, a maioria das listagens devolve uma lista simples (`[...]`), sem o envelope, e ignora `limit`. Para percorrer tudo, peça `page=1` e avance até `page` ser igual a `pages`. Uma página além do fim devolve `docs` vazio.  O tamanho de página padrão é 15, com duas exceções: 25 em Leads, Prospects e Clientes, e 100 em Usuários. Um `limit` inválido cai no padrão.  ## Identificadores e datas  Todo ID é um texto de 24 caracteres hexadecimais, como `507f1f77bcf86cd799439011`. Ao gravar, envie a referência como **ID em texto** — nunca o objeto.  Um ID fora desse formato hoje é respondido com `500`, não `400`: valide o formato antes de enviar.  No corpo e nas respostas, datas são ISO 8601 em UTC, como `2026-05-15T10:00:00Z`. Nos filtros de data da URL (`minDate`, `dateOfExpires_minDate`...), o valor é um **timestamp em milissegundos**, como `1798761600000`; uma data ISO ali não filtra o que você espera.  ## Campos ausentes  Campo sem valor costuma vir **ausente** da resposta, não como `null`. Trate a falta da chave como vazio.  ## Campos personalizados  Os campos criados pelo administrador da conta vão na lista `customFields`:  ```json { \"customFields\": [ { \"customField\": \"507f1f77bcf86cd799439014\", \"k\": \"segmento\", \"v\": \"Tecnologia\" } ] } ```  O valor vai em **`v`**. Um item com `value` é aceito sem erro, mas o campo fica vazio. Descubra os campos e os IDs com `GET /api/customfields?page=1&feature=deal` (troque `deal` por `meeting`, `task`, `contact`...). Com `&required=true` vêm só os obrigatórios da conta.  ## Erros  ```json {   \"reason\": \"Missing required parameters\",   \"message\": \"Missing required parameters\",   \"code\": \"VALIDATION_ERROR\",   \"errors\": [ { \"field\": \"title\", \"message\": \"must NOT have fewer than 1 characters\", \"keyword\": \"minLength\" } ] } ```  | Status | Quando | |---|---| | `400` | Corpo inválido: campo obrigatório ausente, tipo errado, valor fora da lista | | `401` | Token ausente, inválido ou vencido. Corpo: `{\"reason\": \"Access Denied\"}` | | `403` | O Service Account não tem a permissão da rota (`type: SA_PERMISSION_DENIED`, com `requiredPermission`) ou a rota exige administrador (`type: ADMIN_REQUIRED`) | | `404` | Registro não encontrado | | `409` | O registro não está no estado que a operação exige | | `429` | Limite de requisições excedido. Espere o tempo de `Retry-After` |  ## Limite de requisições  Os limites são aplicados por conta. Ao receber `429`, espere os segundos indicados em `Retry-After` e tente de novo com intervalo crescente.  ## Área de trabalho  Em contas com áreas de trabalho, a API define a área do registro pela credencial ou pelo registro pai. Não envie `workspace`.  # Cobertura  Esta referência cobre Contatos (leads, prospects e clientes), Empresas, Oportunidades, Pipelines e etapas, Reuniões, Tarefas, Observações, Usuários e Campos personalizados. Tickets, Atendimentos e Webhooks entram nas próximas revisões.
+ *
+ * The version of the OpenAPI document: 2026-11
+ * Contact: suporte@magnetcustomer.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { Configuration } from '../configuration';
+import type { AxiosPromise, AxiosInstance, RawAxiosRequestConfig } from 'axios';
+import { type RequestArgs, BaseAPI } from '../base';
+import type { CloseDealRequest } from '../models';
+import type { Deal } from '../models';
+import type { DealCreate } from '../models';
+import type { DealInput } from '../models';
+import type { GetDealStageHistory200Response } from '../models';
+import type { ListDeals200Response } from '../models';
+import type { MoveDealStage200Response } from '../models';
+import type { MoveDealStageRequest } from '../models';
+import type { ReopenDealRequest } from '../models';
+import type { ValidateDeal200Response } from '../models';
+/**
+ * DealsApi - axios parameter creator
+ */
+export declare const DealsApiAxiosParamCreator: (configuration?: Configuration) => {
+    /**
+     * Envie `won: true` para ganha, ou `lost: true` com `lostReason` para perdida.
+     * @summary Fechar como ganha ou perdida
+     * @param {string} id ID do registro.
+     * @param {CloseDealRequest} closeDealRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    closeDeal: (id: string, closeDealRequest: CloseDealRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Se `staff` não for enviado, a API usa o usuário da credencial.  A criação é idempotente por 5 minutos: reenviar o mesmo corpo não duplica o registro. Para controlar a chave, envie o cabeçalho `Idempotency-Key`.
+     * @summary Criar oportunidade
+     * @param {DealCreate} dealCreate
+     * @param {string} [idempotencyKey] Chave única da operação (UUID). Repita a mesma chave nas novas tentativas.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    createDeal: (dealCreate: DealCreate, idempotencyKey?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Exclusão lógica (`active: false`). Responde `400` com `code: DEAL_HAS_LINKED_JOURNEYS` se houver jornadas ativas vinculadas.
+     * @summary Excluir oportunidade
+     * @param {string} id ID do registro.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    deleteDeal: (id: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * No detalhe, `pipeline` vem como objeto (`_id`, `title`) e `contact` vem com o cadastro completo.
+     * @summary Obter oportunidade
+     * @param {string} id ID do registro.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getDeal: (id: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Uma entrada por passagem em etapa, com a duração de cada uma e os totais.
+     * @summary Histórico de etapas
+     * @param {string} id ID do registro.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getDealStageHistory: (id: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Ordenação padrão: `createdAt` decrescente.
+     * @summary Listar oportunidades
+     * @param {number} [page] Página, a partir de 1. **Envie sempre**: sem &#x60;page&#x60;, a resposta vem como lista simples, sem o envelope de paginação, e &#x60;limit&#x60; é ignorado.
+     * @param {number} [limit] Registros por página. Padrão: 15, salvo indicação na operação. Máximo: 100 — acima disso a API usa 100.
+     * @param {string} [sortBy] Campo de ordenação. O padrão varia por recurso.
+     * @param {ListDealsSortTypeEnum} [sortType] Direção da ordenação.
+     * @param {string} [pipeline] ID do pipeline.
+     * @param {string} [stage] ID da etapa.
+     * @param {string} [contact] ID do contato.
+     * @param {string} [organization] ID da empresa.
+     * @param {Array<string>} [staffs] Usuários: busca em responsável, participantes e observadores. Repita o parâmetro para enviar vários (&#x60;?staffs&#x3D;id1&amp;staffs&#x3D;id2&#x60;).
+     * @param {Array<string>} [contacts] Vários contatos. Repita o parâmetro para enviar vários (&#x60;?contacts&#x3D;id1&amp;contacts&#x3D;id2&#x60;).
+     * @param {number} [minDate] Fechamento previsto (&#x60;expectedCloseDate&#x60;) a partir de. Timestamp em milissegundos, não data ISO.
+     * @param {number} [maxDate] Fechamento previsto até. Timestamp em milissegundos.
+     * @param {string} [search] Busca em título, nome e e-mail do contato.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listDeals: (page?: number, limit?: number, sortBy?: string, sortType?: ListDealsSortTypeEnum, pipeline?: string, stage?: string, contact?: string, organization?: string, staffs?: Array<string>, contacts?: Array<string>, minDate?: number, maxDate?: number, search?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * A resposta vem em um envelope com `deal` e `oldStageId`, não a oportunidade direta.
+     * @summary Mover de etapa
+     * @param {string} id ID do registro.
+     * @param {MoveDealStageRequest} moveDealStageRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    moveDealStage: (id: string, moveDealStageRequest: MoveDealStageRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Reabre uma oportunidade ganha ou perdida. Responde `409` se ela não estiver fechada.
+     * @summary Reabrir oportunidade
+     * @param {string} id ID do registro.
+     * @param {ReopenDealRequest} [reopenDealRequest]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    reopenDeal: (id: string, reopenDealRequest?: ReopenDealRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Envie só os campos que mudam.
+     * @summary Atualizar oportunidade
+     * @param {string} id ID do registro.
+     * @param {DealInput} dealInput
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    updateDeal: (id: string, dealInput: DealInput, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Diz se a oportunidade tem ações ou campos obrigatórios pendentes. Cada lista traz o que falta; vazia quando não falta nada.
+     * @summary Validar pendências antes de fechar
+     * @param {string} id ID do registro.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    validateDeal: (id: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+};
+/**
+ * DealsApi - functional programming interface
+ */
+export declare const DealsApiFp: (configuration?: Configuration) => {
+    /**
+     * Envie `won: true` para ganha, ou `lost: true` com `lostReason` para perdida.
+     * @summary Fechar como ganha ou perdida
+     * @param {string} id ID do registro.
+     * @param {CloseDealRequest} closeDealRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    closeDeal(id: string, closeDealRequest: CloseDealRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Deal>>;
+    /**
+     * Se `staff` não for enviado, a API usa o usuário da credencial.  A criação é idempotente por 5 minutos: reenviar o mesmo corpo não duplica o registro. Para controlar a chave, envie o cabeçalho `Idempotency-Key`.
+     * @summary Criar oportunidade
+     * @param {DealCreate} dealCreate
+     * @param {string} [idempotencyKey] Chave única da operação (UUID). Repita a mesma chave nas novas tentativas.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    createDeal(dealCreate: DealCreate, idempotencyKey?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Deal>>;
+    /**
+     * Exclusão lógica (`active: false`). Responde `400` com `code: DEAL_HAS_LINKED_JOURNEYS` se houver jornadas ativas vinculadas.
+     * @summary Excluir oportunidade
+     * @param {string} id ID do registro.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    deleteDeal(id: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Deal>>;
+    /**
+     * No detalhe, `pipeline` vem como objeto (`_id`, `title`) e `contact` vem com o cadastro completo.
+     * @summary Obter oportunidade
+     * @param {string} id ID do registro.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getDeal(id: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Deal>>;
+    /**
+     * Uma entrada por passagem em etapa, com a duração de cada uma e os totais.
+     * @summary Histórico de etapas
+     * @param {string} id ID do registro.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getDealStageHistory(id: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<GetDealStageHistory200Response>>;
+    /**
+     * Ordenação padrão: `createdAt` decrescente.
+     * @summary Listar oportunidades
+     * @param {number} [page] Página, a partir de 1. **Envie sempre**: sem &#x60;page&#x60;, a resposta vem como lista simples, sem o envelope de paginação, e &#x60;limit&#x60; é ignorado.
+     * @param {number} [limit] Registros por página. Padrão: 15, salvo indicação na operação. Máximo: 100 — acima disso a API usa 100.
+     * @param {string} [sortBy] Campo de ordenação. O padrão varia por recurso.
+     * @param {ListDealsSortTypeEnum} [sortType] Direção da ordenação.
+     * @param {string} [pipeline] ID do pipeline.
+     * @param {string} [stage] ID da etapa.
+     * @param {string} [contact] ID do contato.
+     * @param {string} [organization] ID da empresa.
+     * @param {Array<string>} [staffs] Usuários: busca em responsável, participantes e observadores. Repita o parâmetro para enviar vários (&#x60;?staffs&#x3D;id1&amp;staffs&#x3D;id2&#x60;).
+     * @param {Array<string>} [contacts] Vários contatos. Repita o parâmetro para enviar vários (&#x60;?contacts&#x3D;id1&amp;contacts&#x3D;id2&#x60;).
+     * @param {number} [minDate] Fechamento previsto (&#x60;expectedCloseDate&#x60;) a partir de. Timestamp em milissegundos, não data ISO.
+     * @param {number} [maxDate] Fechamento previsto até. Timestamp em milissegundos.
+     * @param {string} [search] Busca em título, nome e e-mail do contato.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listDeals(page?: number, limit?: number, sortBy?: string, sortType?: ListDealsSortTypeEnum, pipeline?: string, stage?: string, contact?: string, organization?: string, staffs?: Array<string>, contacts?: Array<string>, minDate?: number, maxDate?: number, search?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ListDeals200Response>>;
+    /**
+     * A resposta vem em um envelope com `deal` e `oldStageId`, não a oportunidade direta.
+     * @summary Mover de etapa
+     * @param {string} id ID do registro.
+     * @param {MoveDealStageRequest} moveDealStageRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    moveDealStage(id: string, moveDealStageRequest: MoveDealStageRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<MoveDealStage200Response>>;
+    /**
+     * Reabre uma oportunidade ganha ou perdida. Responde `409` se ela não estiver fechada.
+     * @summary Reabrir oportunidade
+     * @param {string} id ID do registro.
+     * @param {ReopenDealRequest} [reopenDealRequest]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    reopenDeal(id: string, reopenDealRequest?: ReopenDealRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Deal>>;
+    /**
+     * Envie só os campos que mudam.
+     * @summary Atualizar oportunidade
+     * @param {string} id ID do registro.
+     * @param {DealInput} dealInput
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    updateDeal(id: string, dealInput: DealInput, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Deal>>;
+    /**
+     * Diz se a oportunidade tem ações ou campos obrigatórios pendentes. Cada lista traz o que falta; vazia quando não falta nada.
+     * @summary Validar pendências antes de fechar
+     * @param {string} id ID do registro.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    validateDeal(id: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ValidateDeal200Response>>;
+};
+/**
+ * DealsApi - factory interface
+ */
+export declare const DealsApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    /**
+     * Envie `won: true` para ganha, ou `lost: true` com `lostReason` para perdida.
+     * @summary Fechar como ganha ou perdida
+     * @param {DealsApiCloseDealRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    closeDeal(requestParameters: DealsApiCloseDealRequest, options?: RawAxiosRequestConfig): AxiosPromise<Deal>;
+    /**
+     * Se `staff` não for enviado, a API usa o usuário da credencial.  A criação é idempotente por 5 minutos: reenviar o mesmo corpo não duplica o registro. Para controlar a chave, envie o cabeçalho `Idempotency-Key`.
+     * @summary Criar oportunidade
+     * @param {DealsApiCreateDealRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    createDeal(requestParameters: DealsApiCreateDealRequest, options?: RawAxiosRequestConfig): AxiosPromise<Deal>;
+    /**
+     * Exclusão lógica (`active: false`). Responde `400` com `code: DEAL_HAS_LINKED_JOURNEYS` se houver jornadas ativas vinculadas.
+     * @summary Excluir oportunidade
+     * @param {DealsApiDeleteDealRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    deleteDeal(requestParameters: DealsApiDeleteDealRequest, options?: RawAxiosRequestConfig): AxiosPromise<Deal>;
+    /**
+     * No detalhe, `pipeline` vem como objeto (`_id`, `title`) e `contact` vem com o cadastro completo.
+     * @summary Obter oportunidade
+     * @param {DealsApiGetDealRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getDeal(requestParameters: DealsApiGetDealRequest, options?: RawAxiosRequestConfig): AxiosPromise<Deal>;
+    /**
+     * Uma entrada por passagem em etapa, com a duração de cada uma e os totais.
+     * @summary Histórico de etapas
+     * @param {DealsApiGetDealStageHistoryRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getDealStageHistory(requestParameters: DealsApiGetDealStageHistoryRequest, options?: RawAxiosRequestConfig): AxiosPromise<GetDealStageHistory200Response>;
+    /**
+     * Ordenação padrão: `createdAt` decrescente.
+     * @summary Listar oportunidades
+     * @param {DealsApiListDealsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listDeals(requestParameters?: DealsApiListDealsRequest, options?: RawAxiosRequestConfig): AxiosPromise<ListDeals200Response>;
+    /**
+     * A resposta vem em um envelope com `deal` e `oldStageId`, não a oportunidade direta.
+     * @summary Mover de etapa
+     * @param {DealsApiMoveDealStageRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    moveDealStage(requestParameters: DealsApiMoveDealStageRequest, options?: RawAxiosRequestConfig): AxiosPromise<MoveDealStage200Response>;
+    /**
+     * Reabre uma oportunidade ganha ou perdida. Responde `409` se ela não estiver fechada.
+     * @summary Reabrir oportunidade
+     * @param {DealsApiReopenDealRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    reopenDeal(requestParameters: DealsApiReopenDealRequest, options?: RawAxiosRequestConfig): AxiosPromise<Deal>;
+    /**
+     * Envie só os campos que mudam.
+     * @summary Atualizar oportunidade
+     * @param {DealsApiUpdateDealRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    updateDeal(requestParameters: DealsApiUpdateDealRequest, options?: RawAxiosRequestConfig): AxiosPromise<Deal>;
+    /**
+     * Diz se a oportunidade tem ações ou campos obrigatórios pendentes. Cada lista traz o que falta; vazia quando não falta nada.
+     * @summary Validar pendências antes de fechar
+     * @param {DealsApiValidateDealRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    validateDeal(requestParameters: DealsApiValidateDealRequest, options?: RawAxiosRequestConfig): AxiosPromise<ValidateDeal200Response>;
+};
+/**
+ * Request parameters for closeDeal operation in DealsApi.
+ */
+export interface DealsApiCloseDealRequest {
+    /**
+     * ID do registro.
+     */
+    readonly id: string;
+    readonly closeDealRequest: CloseDealRequest;
+}
+/**
+ * Request parameters for createDeal operation in DealsApi.
+ */
+export interface DealsApiCreateDealRequest {
+    readonly dealCreate: DealCreate;
+    /**
+     * Chave única da operação (UUID). Repita a mesma chave nas novas tentativas.
+     */
+    readonly idempotencyKey?: string;
+}
+/**
+ * Request parameters for deleteDeal operation in DealsApi.
+ */
+export interface DealsApiDeleteDealRequest {
+    /**
+     * ID do registro.
+     */
+    readonly id: string;
+}
+/**
+ * Request parameters for getDeal operation in DealsApi.
+ */
+export interface DealsApiGetDealRequest {
+    /**
+     * ID do registro.
+     */
+    readonly id: string;
+}
+/**
+ * Request parameters for getDealStageHistory operation in DealsApi.
+ */
+export interface DealsApiGetDealStageHistoryRequest {
+    /**
+     * ID do registro.
+     */
+    readonly id: string;
+}
+/**
+ * Request parameters for listDeals operation in DealsApi.
+ */
+export interface DealsApiListDealsRequest {
+    /**
+     * Página, a partir de 1. **Envie sempre**: sem &#x60;page&#x60;, a resposta vem como lista simples, sem o envelope de paginação, e &#x60;limit&#x60; é ignorado.
+     */
+    readonly page?: number;
+    /**
+     * Registros por página. Padrão: 15, salvo indicação na operação. Máximo: 100 — acima disso a API usa 100.
+     */
+    readonly limit?: number;
+    /**
+     * Campo de ordenação. O padrão varia por recurso.
+     */
+    readonly sortBy?: string;
+    /**
+     * Direção da ordenação.
+     */
+    readonly sortType?: ListDealsSortTypeEnum;
+    /**
+     * ID do pipeline.
+     */
+    readonly pipeline?: string;
+    /**
+     * ID da etapa.
+     */
+    readonly stage?: string;
+    /**
+     * ID do contato.
+     */
+    readonly contact?: string;
+    /**
+     * ID da empresa.
+     */
+    readonly organization?: string;
+    /**
+     * Usuários: busca em responsável, participantes e observadores. Repita o parâmetro para enviar vários (&#x60;?staffs&#x3D;id1&amp;staffs&#x3D;id2&#x60;).
+     */
+    readonly staffs?: Array<string>;
+    /**
+     * Vários contatos. Repita o parâmetro para enviar vários (&#x60;?contacts&#x3D;id1&amp;contacts&#x3D;id2&#x60;).
+     */
+    readonly contacts?: Array<string>;
+    /**
+     * Fechamento previsto (&#x60;expectedCloseDate&#x60;) a partir de. Timestamp em milissegundos, não data ISO.
+     */
+    readonly minDate?: number;
+    /**
+     * Fechamento previsto até. Timestamp em milissegundos.
+     */
+    readonly maxDate?: number;
+    /**
+     * Busca em título, nome e e-mail do contato.
+     */
+    readonly search?: string;
+}
+/**
+ * Request parameters for moveDealStage operation in DealsApi.
+ */
+export interface DealsApiMoveDealStageRequest {
+    /**
+     * ID do registro.
+     */
+    readonly id: string;
+    readonly moveDealStageRequest: MoveDealStageRequest;
+}
+/**
+ * Request parameters for reopenDeal operation in DealsApi.
+ */
+export interface DealsApiReopenDealRequest {
+    /**
+     * ID do registro.
+     */
+    readonly id: string;
+    readonly reopenDealRequest?: ReopenDealRequest;
+}
+/**
+ * Request parameters for updateDeal operation in DealsApi.
+ */
+export interface DealsApiUpdateDealRequest {
+    /**
+     * ID do registro.
+     */
+    readonly id: string;
+    readonly dealInput: DealInput;
+}
+/**
+ * Request parameters for validateDeal operation in DealsApi.
+ */
+export interface DealsApiValidateDealRequest {
+    /**
+     * ID do registro.
+     */
+    readonly id: string;
+}
+/**
+ * DealsApi - object-oriented interface
+ */
+export declare class DealsApi extends BaseAPI {
+    /**
+     * Envie `won: true` para ganha, ou `lost: true` com `lostReason` para perdida.
+     * @summary Fechar como ganha ou perdida
+     * @param {DealsApiCloseDealRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    closeDeal(requestParameters: DealsApiCloseDealRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<Deal, any, {}, any>>;
+    /**
+     * Se `staff` não for enviado, a API usa o usuário da credencial.  A criação é idempotente por 5 minutos: reenviar o mesmo corpo não duplica o registro. Para controlar a chave, envie o cabeçalho `Idempotency-Key`.
+     * @summary Criar oportunidade
+     * @param {DealsApiCreateDealRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    createDeal(requestParameters: DealsApiCreateDealRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<Deal, any, {}, any>>;
+    /**
+     * Exclusão lógica (`active: false`). Responde `400` com `code: DEAL_HAS_LINKED_JOURNEYS` se houver jornadas ativas vinculadas.
+     * @summary Excluir oportunidade
+     * @param {DealsApiDeleteDealRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    deleteDeal(requestParameters: DealsApiDeleteDealRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<Deal, any, {}, any>>;
+    /**
+     * No detalhe, `pipeline` vem como objeto (`_id`, `title`) e `contact` vem com o cadastro completo.
+     * @summary Obter oportunidade
+     * @param {DealsApiGetDealRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getDeal(requestParameters: DealsApiGetDealRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<Deal, any, {}, any>>;
+    /**
+     * Uma entrada por passagem em etapa, com a duração de cada uma e os totais.
+     * @summary Histórico de etapas
+     * @param {DealsApiGetDealStageHistoryRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getDealStageHistory(requestParameters: DealsApiGetDealStageHistoryRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<GetDealStageHistory200Response, any, {}, any>>;
+    /**
+     * Ordenação padrão: `createdAt` decrescente.
+     * @summary Listar oportunidades
+     * @param {DealsApiListDealsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listDeals(requestParameters?: DealsApiListDealsRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<import("../models").Page, any, {}, any>>;
+    /**
+     * A resposta vem em um envelope com `deal` e `oldStageId`, não a oportunidade direta.
+     * @summary Mover de etapa
+     * @param {DealsApiMoveDealStageRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    moveDealStage(requestParameters: DealsApiMoveDealStageRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<MoveDealStage200Response, any, {}, any>>;
+    /**
+     * Reabre uma oportunidade ganha ou perdida. Responde `409` se ela não estiver fechada.
+     * @summary Reabrir oportunidade
+     * @param {DealsApiReopenDealRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    reopenDeal(requestParameters: DealsApiReopenDealRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<Deal, any, {}, any>>;
+    /**
+     * Envie só os campos que mudam.
+     * @summary Atualizar oportunidade
+     * @param {DealsApiUpdateDealRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    updateDeal(requestParameters: DealsApiUpdateDealRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<Deal, any, {}, any>>;
+    /**
+     * Diz se a oportunidade tem ações ou campos obrigatórios pendentes. Cada lista traz o que falta; vazia quando não falta nada.
+     * @summary Validar pendências antes de fechar
+     * @param {DealsApiValidateDealRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    validateDeal(requestParameters: DealsApiValidateDealRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ValidateDeal200Response, any, {}, any>>;
+}
+export declare const ListDealsSortTypeEnum: {
+    readonly asc: "asc";
+    readonly desc: "desc";
+};
+export type ListDealsSortTypeEnum = typeof ListDealsSortTypeEnum[keyof typeof ListDealsSortTypeEnum];