Créer une vente

Instructions

Implementation Reference

• src/tools/sales.ts:99-135 (handler)

  The handler function for the sale_create tool that processes input, builds legacy API request body, encodes items list, calls postForm to /workers/webapp.php, and returns the response.

    async (input: SalesCreateArgs, ctx: Ctx) => {
      const { shopId, apiKey } = resolveAuth(undefined, ctx);
    // ---------- Mode legacy ----------
    const body: Record<string, unknown> = {
        idboutique: shopId,
        key: apiKey
    };
  
      if (input.payment !== undefined) body.payment = input.payment;
      if (input.deliveryMethod !== undefined) body.deliveryMethod = String(input.deliveryMethod);
      if (input.idUser !== undefined) body.idUser = input.idUser;
      if (input.idtable !== undefined) body.idtable = input.idtable;
      if (input.idcaisse !== undefined) body.idcaisse = input.idcaisse;
      if (input.numcouverts !== undefined) body.numcouverts = input.numcouverts;
      if (input.publicComment !== undefined) body.publicComment = input.publicComment;
      if (input.privateComment !== undefined) body.privateComment = input.privateComment;
      if (input.pagerNum !== undefined) body.pagerNum = input.pagerNum;
  
  
    if (input.idClient !== undefined) body.idClient = input.idClient;
    if (!input.idClient && input.client) {
      // Le legacy aime les clés client[...]
      for (const [k, v] of Object.entries(input.client)) {
        if (v !== undefined && v !== null && v !== '') {
          body[`client[${k}]`] = String(v);
        }
      }
    }
    body['itemsList[]'] = encodeItemsList(input.items);
  
    const data = await postForm('/workers/webapp.php', body);
  
    return {
      content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
      structuredContent: data,
    };
  }

• src/tools/sales.ts:39-58 (schema)

  Zod input schema (SalesCreateShape) for the sale_create tool, defining parameters like payment, deliveryMethod, client details, and items array. References ClientShape and SalesItemShape.

  const SalesCreateShape = {
  
      payment: z.union([z.number(), z.string()]).transform((v) => Number(v)).optional(),
    deliveryMethod: z.union([
      z.number().int().min(0).max(6),
      z.enum(['0','1','2','3','4','5','6'])
    ]).transform((v) => Number(v)).optional(),
  
      idtable: z.union([z.number().int(), z.string()]).optional(),
      idcaisse: z.union([z.number().int(), z.string()]).optional(),
      numcouverts: z.union([z.number().int(), z.string()]).optional(),
      publicComment: z.string().optional(),
      privateComment: z.string().optional(),
      pagerNum: z.union([z.number().int(), z.string()]).optional(),
      idUser: z.union([z.number().int(), z.string()]).optional(),
    idClient: z.union([z.number().int(), z.string()]).optional(),
    client: z.object(ClientShape).partial().optional(),
  
    items: z.array(z.object(SalesItemShape)).min(1),
  } satisfies Record<string, ZodTypeAny>;

• src/tools/sales.ts:92-136 (registration)

  MCP server registration of the sale_create tool within registerSalesTools, specifying name, i18n title/description, input schema, and handler function.

  server.registerTool(
    'sale_create',
    {
      title: t('tools.sale_create.title'),
      description: t('tools.sale_create.description'),
      inputSchema: SalesCreateShape, // ✅ ZodRawShape
    },
      async (input: SalesCreateArgs, ctx: Ctx) => {
        const { shopId, apiKey } = resolveAuth(undefined, ctx);
      // ---------- Mode legacy ----------
      const body: Record<string, unknown> = {
          idboutique: shopId,
          key: apiKey
      };
  
        if (input.payment !== undefined) body.payment = input.payment;
        if (input.deliveryMethod !== undefined) body.deliveryMethod = String(input.deliveryMethod);
        if (input.idUser !== undefined) body.idUser = input.idUser;
        if (input.idtable !== undefined) body.idtable = input.idtable;
        if (input.idcaisse !== undefined) body.idcaisse = input.idcaisse;
        if (input.numcouverts !== undefined) body.numcouverts = input.numcouverts;
        if (input.publicComment !== undefined) body.publicComment = input.publicComment;
        if (input.privateComment !== undefined) body.privateComment = input.privateComment;
        if (input.pagerNum !== undefined) body.pagerNum = input.pagerNum;
  
  
      if (input.idClient !== undefined) body.idClient = input.idClient;
      if (!input.idClient && input.client) {
        // Le legacy aime les clés client[...]
        for (const [k, v] of Object.entries(input.client)) {
          if (v !== undefined && v !== null && v !== '') {
            body[`client[${k}]`] = String(v);
          }
        }
      }
      body['itemsList[]'] = encodeItemsList(input.items);
  
      const data = await postForm('/workers/webapp.php', body);
  
      return {
        content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
        structuredContent: data,
      };
    }
  );

• src/tools/sales.ts:63-88 (helper)

  Helper function to encode the items array into the legacy 'itemsList[]' string format required by the API.

  function encodeItemsList(items: SalesCreateArgs['items']): string[] {
    const out: string[] = [];
    for (const it of items) {
        if (it.type === 'catalog') {
            const parts = [
                it.productId ?? '',
                it.quantity ?? 1,
                it.titleOverride ?? '',
                it.priceOverride ?? '',
            ];
            if (it.declinaisons?.length) parts.push(...it.declinaisons);
            out.push(parts.join('_'));
        } else if (it.type === 'free') {
            const parts = [
                'Free',
                it.priceOverride ?? '',
                it.titleOverride ?? '',
            ];
            out.push(parts.join('_'));
        } else {
            // ligne libre : -<departmentId>_<price>_<title>
            out.push(`-${it.departmentId ?? ''}_${it.price ?? ''}_${it.title ?? ''}`);
        }
    }
    return out;
  }

• src/index.ts:61-61 (registration)

  Invocation of registerSalesTools to register sale tools including sale_create in the main MCP server setup.

  registerSalesTools(mcpServer);