siigo_create_invoice

Instructions

Implementation Reference

• src/siigo-client.ts:108-110 (handler)

  Core handler implementation for creating an invoice via POST to Siigo API /v1/invoices endpoint.

  async createInvoice(invoice: SiigoInvoice): Promise<SiigoApiResponse<SiigoInvoice>> {
    return this.makeRequest<SiigoInvoice>('POST', '/v1/invoices', invoice);
  }

• src/index.ts:914-923 (handler)

  MCP server handler that receives tool call params and delegates to SiigoClient.createInvoice, formats response.

  private async handleCreateInvoice(args: any) {
    const result = await this.siigoClient.createInvoice(args.invoice);
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(result, null, 2),
        },
      ],
    };

• src/index.ts:374-396 (registration)

  Tool registration in MCP server's getTools() method, including name, description, and detailed input schema.

  {
    name: 'siigo_create_invoice',
    description: 'Create a new invoice',
    inputSchema: {
      type: 'object',
      properties: {
        invoice: {
          type: 'object',
          description: 'Invoice data',
          properties: {
            document: { type: 'object', properties: { id: { type: 'number' } }, required: ['id'] },
            date: { type: 'string', description: 'Invoice date (YYYY-MM-DD)' },
            customer: { type: 'object', description: 'Customer information' },
            seller: { type: 'number', description: 'Seller ID' },
            items: { type: 'array', items: { type: 'object' }, description: 'Invoice items' },
            payments: { type: 'array', items: { type: 'object' }, description: 'Payment methods' },
          },
          required: ['document', 'date', 'customer', 'seller', 'items', 'payments'],
        },
      },
      required: ['invoice'],
    },
  },

• src/types.ts:94-143 (schema)

  TypeScript interface defining the structure of SiigoInvoice used for input validation and API calls.

  export interface SiigoInvoice {
    id?: string;
    document: {
      id: number;
      number?: number;
    };
    date: string;
    customer: {
      person_type?: string;
      id_type?: string;
      identification: string;
      branch_office?: number;
      name?: string[];
      address?: any;
      phones?: any[];
      contacts?: any[];
    };
    cost_center?: number;
    currency?: {
      code: string;
      exchange_rate: number;
    };
    seller: number;
    observations?: string;
    items: Array<{
      code: string;
      description?: string;
      quantity: number;
      price: number;
      discount?: number;
      taxes?: Array<{ id: number }>;
    }>;
    payments: Array<{
      id: number;
      value: number;
      due_date?: string;
    }>;
    stamp?: {
      send: boolean;
    };
    mail?: {
      send: boolean;
    };
    global_discounts?: Array<{
      id: number;
      percentage?: number;
      value?: number;
    }>;
    additional_fields?: any;
  }

• src/siigo-client.ts:41-59 (helper)

  Helper method for making authenticated HTTP requests to Siigo API, used by createInvoice and all other endpoints.

  private async makeRequest<T>(method: string, endpoint: string, data?: any, params?: any): Promise<SiigoApiResponse<T>> {
    await this.authenticate();
  
    try {
      const response: AxiosResponse<SiigoApiResponse<T>> = await this.httpClient.request({
        method,
        url: endpoint,
        data,
        params,
      });
  
      return response.data;
    } catch (error: any) {
      if (error.response?.data) {
        return error.response.data;
      }
      throw new Error(`API request failed: ${error.message}`);
    }
  }