AP 송장 API 개발자 가이드

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 5분

    • 이 개발자 가이드에서는 에 대한 AP 송장 API와 함께 기본적으로 제공되지 않는 사용자 지정 송장 필드를 정의하는 방법을 설명합니다.외상 매입금 송장 처리 cXML을 페이로드로 사용할 때 인증을 설정하기 위한 지침도 제공됩니다.

    요청 본문에 대한 사용자 지정 송장 필드를 정의할 수 있습니다. 다음 플로우를 사용하여 사용자 지정 필드를 추가하고, 대상 테이블에 매핑하고, 페이로드에서 사용할 수 있도록 형식을 지정합니다.
    1. 송장 임포트를 위한 사용자 지정 필드 추가
    2. 소스와 대상 테이블 간에 사용자 지정 필드 매핑
    3. 사용자 지정 필드를 페이로드 소스 형식으로 매핑

    소스 시스템 자격 증명 [sn_spend_intg_source_system_credential] 테이블에서 cXML 페이로드에 대한 자격 증명을 정의합니다. 지침은 cXML 페이로드에서 인증을 위한 자격 증명 설정 문서를 참조하십시오.

    여러 ERP가 포함된 송장 라인에 필터 조건을 적용할 수 있습니다. 자세한 내용은 Integration errors 문서를 참조하십시오.

    참조 :

    송장 임포트를 위한 사용자 지정 필드 추가

    다음 절차에 따라 AP 송장 API와 함께 사용할 송장, 송장 라인 및 송장 세금 라인에 대한 사용자 지정 필드를 추가합니다.

    시작하기 전에

    프로시저

    1. 다음으로 이동 모두 > 시스템 정의 > 테이블.
    2. 다음 송장 임포트 테이블 중 하나를 선택합니다.
      • 송장 임포트 [sn_spend_intg_imp_invoice]
      • 송장 라인 임포트 [sn_spend_intg_imp_invoice_line]
      • 송장 세금 라인 임포트 [sn_spend_intg_imp_invoice_tax_line]
    3. 테이블 열 탭에서 새로 만들기를 선택합니다.
    4. 유형 메뉴에서 필드 값과 연결된 유형(예: 정수)을 선택합니다.
      주:
      유효한 유형 목록은 다음 문서를 참조하십시오 Field types reference.
    5. 열 레이블 필드에 의미 있는 이름을 입력합니다.
      레이블을 포함한 텍스트는 열 이름 필드에 자동으로 채워집니다.
    6. 저장 또는 제출을 선택합니다.
    7. 송장 [sn_shop_invoice] 테이블에 이름과 유형이 같은 열을 추가합니다.
      주:
      열과 필드에 대한 자세한 내용은 다음 문서를 참조하십시오 Exploring field administration.
    8. 소스와 대상 테이블 간에 필드를 매핑합니다.

    소스와 대상 테이블 간에 사용자 지정 필드 매핑

    다음 절차에 따라 AP 송장 API에 대한 원본 테이블과 대상 테이블 간에 사용자 지정 필드를 매핑합니다.

    시작하기 전에

    소스 테이블에서 대상 테이블로 새 필드를 매핑하기 위한 테이블 열을 생성합니다. 다음의 송장 임포트를 위한 사용자 지정 필드 추가단계를 사용합니다.

    프로시저

    1. 다음으로 이동 모두 > 시스템 임포트 세트 > 변환 맵.
    2. 송장 임포트 테이블 변환 맵을 엽니다.
    3. 필드 맵 탭에서 새로 만들기를 클릭합니다.
    4. 소스 필드 메뉴에서 사용자 지정 필드의 이름을 선택합니다.
    5. 대상 필드 메뉴에서 사용자 지정 필드의 이름을 선택합니다.
    6. 저장 또는 제출을 선택합니다.
    7. 사용자 지정 필드를 페이로드 소스 형식으로 매핑.

    사용자 지정 필드를 페이로드 소스 형식으로 매핑

    다음 절차에 따라 사용자 지정 필드를 AP 송장 API에 대한 JSON, cXML 또는 XML의 페이로드 항목에 매핑합니다.

    시작하기 전에

    프로시저

    1. 다음으로 이동 모두 > 구매 통합 > 공급자 > 송장 통합 필드 매핑.
    2. 새로 만들기를 선택합니다.
    3. 소스 시스템 필드에 소스 시스템의 이름을 추가합니다.
      • 이 필드 매핑이 모든 소스 시스템에 적용되는 경우 기본값을 입력합니다.
      • 매핑이 특정 소스 시스템과 관련된 경우 이 값은 API에서 받은 Source-System 헤더 매개변수의 값과 일치해야 합니다.
        주:
        나머지 필드 매핑은 모두 이 소스 시스템에 대해 특별히 구성해야 합니다.
    4. 소스 형식 선택 목록(cXML 또는 JSON)에서 매핑을 생성할 소스 시스템의 형식을 선택합니다.
    5. 소스 필드 필드에 페이로드 항목의 이름(JSON 속성) 또는 경로(cXML/XML 속성 또는 요소)를 입력합니다.
      송장 통합 필드 매핑 [sn_spend_intg_invoice_intg_field_mapping] 테이블에서 cXML 및 XML 경로 설정의 예를 볼 수 있습니다.
    6. 필드가 cXML 페이로드에 대한 요소 속성으로 정의되는 경우 속성 이름을 추가하고, 그렇지 않으면 필드를 비워 둡니다.
    7. 관련 테이블 목록에서 사용자 지정 필드가 포함된 대상 테이블의 이름을 선택합니다.
    8. 대상 필드 목록에서 사용자 지정 필드의 이름을 선택합니다.
    9. 저장 또는 제출을 선택합니다.
      매핑된 필드가 송장 통합 필드 매핑 [sn_spend_intg_invoice_intg_field_mapping] 테이블에 추가됩니다.

    cXML 페이로드에서 인증을 위한 자격 증명 설정

    sn_spend_intg/ap_invoice/cxml 엔드포인트는 소스 시스템 자격 증명 [sn_spend_intg_source_system_credential] 테이블에 저장된 자격 증명을 사용하여 페이로드에서 인증됩니다.

    시작하기 전에

    필요한 역할: 관리자

    송장 통합 필드 매핑 [sn_spend_intg_invoice_intg_field_mapping] 테이블에 나열된 페이로드 소스 시스템을 식별합니다.

    AP 송장 – POST sn_spend_intg/ap_invoice/cxml 또한 참조하십시오.

    프로시저

    1. 다음으로 이동 모두 > 구매 통합 > 소스 시스템 자격 증명.
    2. 새로 만들기를 선택합니다.
    3. 송장 통합 필드 매핑 [sn_spend_intg_invoice_intg_field_mapping] 테이블에 나열된 소스 시스템의 이름을 소스 시스템 필드에 추가합니다.
      소스 시스템 이름은 Source-System 헤더 매개변수와 일치해야 합니다.
    4. 사용자 이름 필드에서 가져올 사용자 이름을 추가합니다.
      /cXML/Header/To/Credential [@domain='NetworkID']/Identity 요소에서 이 값을 사용합니다.
    5. 암호 필드에 문자, 숫자 및 특수 문자의 강력한 조합을 추가합니다.
      /cXML/Header/Sender/Credential [@domain='NetworkID']/SharedSecret 요소에서 이 값을 사용합니다.
    6. 제출을 선택합니다.