AP 송장 API 개발자 안내서

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

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

1. 송장 임포트를 위한 사용자 지정 필드 추가
2. 소스와 대상 테이블 간 사용자 지정 필드 매핑
3. 사용자 지정 필드를 페이로드 소스 형식에 매핑

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

참조:

• Accounts Payable Invoice Processing
• AP 송장 API

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

다음 절차를 사용하여 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. 소스 시스템 필드에 소스 시스템의 이름을 추가합니다.
   • 이 필드 매핑이 모든 소스 시스템에 적용되는 경우 Default를 입력합니다.
   • 매핑이 특정 소스 시스템과 관련된 경우 이 값은 API에서 받은 소스-시스템 헤더 매개변수의 값과 일치해야 합니다.
     주:

     나머지 필드 매핑은 모두 이 소스 시스템에 맞게 구성되어야 합니다.
4. 소스 형식 선택 목록에서 매핑을 생성할 소스 시스템의 형식(cXML 또는 JSON)을 선택합니다.
5. 소스 필드 필드에 페이로드 항목의 이름(JSON 속성) 또는 경로(cXML/XML 속성 또는 요소)를 입력합니다.
   cXML 및 XML 경로 설정의 예는 송장 통합 필드 매핑 [sn_spend_intg_invoice_intg_field_mapping] 테이블을 볼 수 있습니다.
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. 제출을 선택합니다.