무료GitHub에 공개

extract-cfdi-nomina-data

Extract structured fields from cfdi nomina documents.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

iterationlayer/skills

연동 도구n8n

설치 방법 보기

포함된 파일(1)

SKILL.md12.3 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Extract Cfdi Nomina Data

Payroll and HR teams use this recipe to extract Cfdi Nomina fields into structured JSON for payroll checks, employee records, and finance reconciliation.

APIs Used

Document Extraction (1 credit per page)

Prerequisites

You need an Iteration Layer API key. Get one at platform.iterationlayer.com during the 7-day trial.

For full integration guidance (SDKs, auth, MCP, error handling), see the Iteration Layer Integration Guide.

Implementation

curl -X POST https://api.iterationlayer.com/document-extraction/v1/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "files": [
    {
      "type": "url",
      "name": "cfdi-nomina.pdf",
      "url": "https://example.com/documents/cfdi-nomina-sample.pdf"
    }
  ],
  "schema": {
    "fields": [
      {
        "name": "employee_name",
        "type": "TEXT",
        "description": "Employee name"
      },
      {
        "name": "employer_name",
        "type": "TEXT",
        "description": "Employer name"
      },
      {
        "name": "employee_identifier",
        "type": "TEXT",
        "description": "Employee, payroll, or taxpayer identifier"
      },
      {
        "name": "period_end_date",
        "type": "DATE",
        "description": "Pay period, statement, or tax year end date"
      },
      {
        "name": "gross_pay",
        "type": "CURRENCY_AMOUNT",
        "description": "Gross pay or taxable compensation"
      },
      {
        "name": "tax_withheld",
        "type": "CURRENCY_AMOUNT",
        "description": "Tax withheld"
      },
      {
        "name": "social_contributions",
        "type": "CURRENCY_AMOUNT",
        "description": "Social security or payroll contributions"
      },
      {
        "name": "net_pay",
        "type": "CURRENCY_AMOUNT",
        "description": "Net pay"
      },
      {
        "name": "currency",
        "type": "CURRENCY_CODE",
        "description": "Currency code"
      }
    ]
  }
}'

import { IterationLayer } from "iterationlayer";

const client = new IterationLayer({ apiKey: "YOUR_API_KEY" });

const result = await client.extractDocument({
  "files": [
    {
      "type": "url",
      "name": "cfdi-nomina.pdf",
      "url": "https://example.com/documents/cfdi-nomina-sample.pdf"
    }
  ],
  "schema": {
    "fields": [
      {
        "name": "employee_name",
        "type": "TEXT",
        "description": "Employee name"
      },
      {
        "name": "employer_name",
        "type": "TEXT",
        "description": "Employer name"
      },
      {
        "name": "employee_identifier",
        "type": "TEXT",
        "description": "Employee, payroll, or taxpayer identifier"
      },
      {
        "name": "period_end_date",
        "type": "DATE",
        "description": "Pay period, statement, or tax year end date"
      },
      {
        "name": "gross_pay",
        "type": "CURRENCY_AMOUNT",
        "description": "Gross pay or taxable compensation"
      },
      {
        "name": "tax_withheld",
        "type": "CURRENCY_AMOUNT",
        "description": "Tax withheld"
      },
      {
        "name": "social_contributions",
        "type": "CURRENCY_AMOUNT",
        "description": "Social security or payroll contributions"
      },
      {
        "name": "net_pay",
        "type": "CURRENCY_AMOUNT",
        "description": "Net pay"
      },
      {
        "name": "currency",
        "type": "CURRENCY_CODE",
        "description": "Currency code"
      }
    ]
  }
});

from iterationlayer import IterationLayer

client = IterationLayer(api_key="YOUR_API_KEY")

result = client.extract_document(**{
  "files": [
    {
      "type": "url",
      "name": "cfdi-nomina.pdf",
      "url": "https://example.com/documents/cfdi-nomina-sample.pdf"
    }
  ],
  "schema": {
    "fields": [
      {
        "name": "employee_name",
        "type": "TEXT",
        "description": "Employee name"
      },
      {
        "name": "employer_name",
        "type": "TEXT",
        "description": "Employer name"
      },
      {
        "name": "employee_identifier",
        "type": "TEXT",
        "description": "Employee, payroll, or taxpayer identifier"
      },
      {
        "name": "period_end_date",
        "type": "DATE",
        "description": "Pay period, statement, or tax year end date"
      },
      {
        "name": "gross_pay",
        "type": "CURRENCY_AMOUNT",
        "description": "Gross pay or taxable compensation"
      },
      {
        "name": "tax_withheld",
        "type": "CURRENCY_AMOUNT",
        "description": "Tax withheld"
      },
      {
        "name": "social_contributions",
        "type": "CURRENCY_AMOUNT",
        "description": "Social security or payroll contributions"
      },
      {
        "name": "net_pay",
        "type": "CURRENCY_AMOUNT",
        "description": "Net pay"
      },
      {
        "name": "currency",
        "type": "CURRENCY_CODE",
        "description": "Currency code"
      }
    ]
  }
})

package main

import il "github.com/iterationlayer/sdk-go"

func main() {
	client := il.NewClient("YOUR_API_KEY")

	result, err := client.ExtractDocument(il.ExtractDocumentRequest{
		Files: []il.FileInput{
			il.FileInput{
				Type: "url",
				Name: "cfdi-nomina.pdf",
				Url: "https://example.com/documents/cfdi-nomina-sample.pdf",
			},
		},
		Schema: il.ExtractionSchema{
			Fields: []any{
				il.TextFieldConfig{
					Name: "employee_name",
					Type: "TEXT",
					Description: "Employee name",
				},
				il.TextFieldConfig{
					Name: "employer_name",
					Type: "TEXT",
					Description: "Employer name",
				},
				il.TextFieldConfig{
					Name: "employee_identifier",
					Type: "TEXT",
					Description: "Employee, payroll, or taxpayer identifier",
				},
				il.DateFieldConfig{
					Name: "period_end_date",
					Type: "DATE",
					Description: "Pay period, statement, or tax year end date",
				},
				il.CurrencyAmountFieldConfig{
					Name: "gross_pay",
					Type: "CURRENCY_AMOUNT",
					Description: "Gross pay or taxable compensation",
				},
				il.CurrencyAmountFieldConfig{
					Name: "tax_withheld",
					Type: "CURRENCY_AMOUNT",
					Description: "Tax withheld",
				},
				il.CurrencyAmountFieldConfig{
					Name: "social_contributions",
					Type: "CURRENCY_AMOUNT",
					Description: "Social security or payroll contributions",
				},
				il.CurrencyAmountFieldConfig{
					Name: "net_pay",
					Type: "CURRENCY_AMOUNT",
					Description: "Net pay",
				},
				il.CurrencyCodeFieldConfig{
					Name: "currency",
					Type: "CURRENCY_CODE",
					Description: "Currency code",
				},
			},
		},
	})
	if err != nil {
		panic(err)
	}

	_ = result
}

{
  "name": "Extract Cfdi Nomina Data",
  "nodes": [
    {
      "parameters": {
        "content": "## Extract Cfdi Nomina Data\n\nPayroll and HR teams use this recipe to extract Cfdi Nomina fields into structured JSON for payroll checks, employee records, and finance reconciliation.\n\n**Note:** This workflow uses the Iteration Layer community node (`n8n-nodes-iterationlayer`). Install it via Settings > Community Nodes on self-hosted n8n, or add it directly on n8n Cloud with Verified Community Nodes enabled.",
        "height": 280,
        "width": 500,
        "color": 2
      },
      "type": "n8n-nodes-base.stickyNote",
      "typeVersion": 1,
      "position": [
        200,
        40
      ],
      "id": "extract-cfdi-nomina-data-overview",
      "name": "Overview"
    },
    {
      "parameters": {},
      "type": "n8n-nodes-base.manualTrigger",
      "typeVersion": 1,
      "position": [
        250,
        300
      ],
      "id": "extract-cfdi-nomina-data-trigger",
      "name": "Manual Trigger"
    },
    {
      "parameters": {
        "resource": "documentExtraction",
        "schemaInputMode": "rawJson",
        "schemaJson": "{\n  \"fields\": [\n    {\n      \"name\": \"employee_name\",\n      \"type\": \"TEXT\",\n      \"description\": \"Employee name\"\n    },\n    {\n      \"name\": \"employer_name\",\n      \"type\": \"TEXT\",\n      \"description\": \"Employer name\"\n    },\n    {\n      \"name\": \"employee_identifier\",\n      \"type\": \"TEXT\",\n      \"description\": \"Employee, payroll, or taxpayer identifier\"\n    },\n    {\n      \"name\": \"period_end_date\",\n      \"type\": \"DATE\",\n      \"description\": \"Pay period, statement, or tax year end date\"\n    },\n    {\n      \"name\": \"gross_pay\",\n      \"type\": \"CURRENCY_AMOUNT\",\n      \"description\": \"Gross pay or taxable compensation\"\n    },\n    {\n      \"name\": \"tax_withheld\",\n      \"type\": \"CURRENCY_AMOUNT\",\n      \"description\": \"Tax withheld\"\n    },\n    {\n      \"name\": \"social_contributions\",\n      \"type\": \"CURRENCY_AMOUNT\",\n      \"description\": \"Social security or payroll contributions\"\n    },\n    {\n      \"name\": \"net_pay\",\n      \"type\": \"CURRENCY_AMOUNT\",\n      \"description\": \"Net pay\"\n    },\n    {\n      \"name\": \"currency\",\n      \"type\": \"CURRENCY_CODE\",\n      \"description\": \"Currency code\"\n    }\n  ]\n}",
        "files": {
          "fileValues": [
            {
              "fileInputMode": "url",
              "fileName": "cfdi-nomina.pdf",
              "fileUrl": "https://example.com/documents/cfdi-nomina-sample.pdf"
            }
          ]
        }
      },
      "type": "n8n-nodes-iterationlayer.iterationLayer",
      "typeVersion": 1,
      "position": [
        500,
        300
      ],
      "id": "extract-cfdi-nomina-data-extract",
      "name": "Extract Data",
      "credentials": {
        "iterationLayerApi": {
          "id": "1",
          "name": "Iteration Layer API"
        }
      }
    }
  ],
  "connections": {
    "Manual Trigger": {
      "main": [
        [
          {
            "node": "Extract Data",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  },
  "settings": {
    "executionOrder": "v1"
  }
}

Extract cfdi nomina data from the file at [file URL]. Use the extract_document tool with these fields:

- employee_name (TEXT): Employee name
- employer_name (TEXT): Employer name
- employee_identifier (TEXT): Employee, payroll, or taxpayer identifier
- period_end_date (DATE): Pay period, statement, or tax year end date
- gross_pay (CURRENCY_AMOUNT): Gross pay or taxable compensation
- tax_withheld (CURRENCY_AMOUNT): Tax withheld
- social_contributions (CURRENCY_AMOUNT): Social security or payroll contributions
- net_pay (CURRENCY_AMOUNT): Net pay
- currency (CURRENCY_CODE): Currency code

Response

{
  "success": true,
  "data": {
    "employee_name": {
      "value": "Employee Name",
      "confidence": 0.97,
      "citations": [
        "EMPLOYEE NAME"
      ]
    },
    "employer_name": {
      "value": "Employer Name",
      "confidence": 0.97,
      "citations": [
        "EMPLOYER NAME"
      ]
    },
    "employee_identifier": {
      "value": "Employee Identifier",
      "confidence": 0.97,
      "citations": [
        "EMPLOYEE IDENTIFIER"
      ]
    },
    "period_end_date": {
      "value": "2026-04-15",
      "confidence": 0.97,
      "citations": [
        "15 Apr 2026"
      ]
    },
    "gross_pay": {
      "value": {
        "amount": "1234.56",
        "currency": "USD"
      },
      "confidence": 0.97,
      "citations": [
        "$1,234.56"
      ]
    },
    "tax_withheld": {
      "value": {
        "amount": "1234.56",
        "currency": "USD"
      },
      "confidence": 0.97,
      "citations": [
        "$1,234.56"
      ]
    },
    "social_contributions": {
      "value": {
        "amount": "1234.56",
        "currency": "USD"
      },
      "confidence": 0.97,
      "citations": [
        "$1,234.56"
      ]
    },
    "net_pay": {
      "value": {
        "amount": "1234.56",
        "currency": "USD"
      },
      "confidence": 0.97,
      "citations": [
        "$1,234.56"
      ]
    },
    "currency": {
      "value": "USD",
      "confidence": 0.97,
      "citations": [
        "CURRENCY"
      ]
    }
  }
}

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

같은 저장소의 스킬

compress-image-for-email

무료

Resize, sharpen, and compress an image to fit email platform size limits in a single pipeline.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

iterationlayer/skills42026년 6월 9일 업데이트

compress-image-to-target-size

무료

Compress an image to fit within a specific file size in bytes using quality-first compression.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

iterationlayer/skills42026년 6월 9일 업데이트

convert-contract-to-markdown

무료

Convert a contract PDF to clean markdown for clause extraction or LLM analysis.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

iterationlayer/skills42026년 6월 9일 업데이트

convert-document-for-knowledge-base

무료

Convert external documents — specs, contracts, reports — to markdown for knowledge base ingestion.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

iterationlayer/skills42026년 6월 9일 업데이트

convert-document-for-rag-ingestion

무료

Convert a document to clean markdown suitable for chunking and embedding in a RAG pipeline.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

iterationlayer/skills42026년 6월 9일 업데이트

convert-image-format

무료

Convert an image between PNG, JPEG, and WebP formats with quality control for web optimization.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

iterationlayer/skills42026년 6월 9일 업데이트

iterationlayer의 스킬 모두 보기

이 스킬의 문제 신고

설치

명령으로 설치

npx skills add https://github.com/iterationlayer/skills --skill extract-cfdi-nomina-data

터미널에 붙여 넣고 실행합니다(Node.js 필요). Claude Code, Codex 등 설치할 에이전트를 고를 수 있습니다.

에이전트에게 부탁하기

다음 Agent Skill을 설치해 주세요.
https://github.com/iterationlayer/skills/tree/main/skills/extract-cfdi-nomina-data

먼저 SKILL.md와 첨부 파일의 내용을 확인해 수상한 처리(외부 전송, 인증 정보 읽기 등)가 없는지 확인한 뒤 Claude Code는 ~/.claude/skills/extract-cfdi-nomina-data/, Codex는 ~/.agents/skills/extract-cfdi-nomina-data/ 에 배치해 주세요.

이 문장을 그대로 Claude Code나 Codex에 보내면 내용을 확인한 뒤 설치해 줍니다.

GitHub에서 소스 보기

저장소: iterationlayer/skills
스타: 4
포크: 0
카테고리: 데이터·AI
라이선스: MIT
원문 언어: 영어
최종 업데이트: 2026년 6월 9일

스킬은 에이전트를 위한 지시와 스크립트의 묶음입니다. cccskills는 내용의 안전성을 보증하지 않습니다. 설치하기 전에 내용을 확인하세요.

포함된 파일(1)

SKILL.md(원문)

Extract Cfdi Nomina Data

APIs Used

Prerequisites

Implementation

Response

Links

리뷰

댓글

같은 저장소의 스킬

compress-image-for-email

compress-image-to-target-size

convert-contract-to-markdown

convert-document-for-knowledge-base

convert-document-for-rag-ingestion

convert-image-format