invoice grid columns

The invoice grid columns extension point adds columns to the grid on the Sales > Invoices page in the Adobe Commerce Admin. It calls a runtimeAction in your App Builder app directly, the same as the order and product grid columns extension points.

Example customization

The following example creates a custom column labeled Warehouse Location, backed by a get-invoice-grid-columns runtime action.

adminUi: {
  invoice: {
    gridColumns: {
      label: 'Invoice grid columns',
      description: 'Adds custom columns to the invoice grid',
      runtimeAction: 'invoice-custom-grid-columns/get-invoice-grid-columns',
      columns: [
        { id: 'warehouse_location', label: 'Warehouse Location', type: 'string', align: 'left' },
      ],
    },
  },
},

How it works

1. A merchant opens the invoice grid (Sales > Invoices) in the Commerce Admin.
2. Commerce sends a POST request to your runtime action with the grid type and the visible invoice IDs: { requestId, gridType: 'invoice', ids: ['000000001', '000000002', ...] }.
3. Your action looks up the column values for each invoice ID and returns them.
4. Commerce renders the returned values in the corresponding columns, alongside the built-in columns.

For IDs your action does not return, Commerce falls back to the default values your action declares. If no default is provided, the cell is left empty.

Parameters