개요: 어떤 연결이 적합한지
- n8n, Make, Zapier와 같은 자동화 플랫폼: API 키를 사용한 REST API와 웹훅을 통해 연결됩니다. n8n은 PaperOffice MCP 서버도 사용할 수 있습니다.
- ERP 및 회계 시스템: Holded와 JTL-Wawi를 위한 사전 구성된 연결이 주문, 청구서, 가격을 운영 소스로 반영합니다.
- 운송사: GLS, DB Schenker 및 DHL를 위한 사전 구성된 연결로 배송 상태를 조회합니다.
- 데이터 서비스: 부가세 ID 확인, 환율, 지오코딩 및 지도는 앱 내에서 및 API를 통해 제공됩니다.
운영 소스는 Knowledge Base AI의 일부이며, Plus 플랜부터 이용 가능합니다. 고객 인증이 완료된 후에만 채팅 또는 전화 에이전트가 주문 상태와 같은 고객 데이터를 공유합니다.
n8n, Make 및 Zapier
이 도구들의 표준 빌딩 블록을 사용합니다: REST API로의 HTTP 요청과 웹훅입니다.
- API 키 페이지에서 키를 생성하고, HTTP 노드에 Bearer 토큰으로 입력합니다.
- 업로드 또는 검색 등 REST API를 호출합니다. 엔드포인트는 API 문서에 있습니다.
- 결과를 받으려면 Workflow AI → Workflow Agents로 이동하여 저장된 에이전트를 편집하고 웹훅 탭을 선택합니다.
- 웹훅 대상 추가를 클릭하고 n8n, Make 또는 Zapier의 웹훅 주소를 타겟 URL로 입력합니다.
- 전송 시점에서 작업 성공, 작업 실패 또는 둘 다를 선택합니다.
- 사람의 검토가 필요한 경우, 흐름이 검토 작업을 생성하고 웹훅을 기다립니다. task.completed 이벤트가 결정을 보고합니다.
- PaperOffice의 웹훅은 X-PaperOffice-Signature 헤더에 서명됩니다. 흐름에서 서명을 확인하십시오.
- {trigger.pofid}와 같은 플레이스홀더는 경로, 쿼리 및 헤더에 허용되지만 호스트 이름에는 허용되지 않습니다.
- 워크플로우 에이전트의 웹훅 대상은 Professional 플랜부터 이용 가능합니다. 각 성공적인 웹훅 전송은 유료이며, API 호출도 유료입니다.
Holded
PaperOffice는 Holded에서 연락처 정보가 포함된 판매 주문, 청구서, 크레딧 노트 및 제품을 읽으며 운영 소스로 반영합니다. 이 반영은 읽기 전용입니다. 첨부 파일만 Holded로 전송되며, 별도의 옵트인(opt-in)과 쓰기 권한이 있는 별도 키가 필요합니다.
- Knowledge Base AI → 운영 소스로 이동하여 출처 추가를 클릭하고 연결로 Holded를 선택합니다.
- 연결 탭에서 Holded API 키를 입력합니다.
- 선택 사항: 문서용 워크스페이스를 선택하고 청구서, 크레딧 노트 또는 판매 주문에 체크합니다. PDF 보관은 저장 후 새로 생성된 문서에만 적용됩니다.
- 선택 사항: Holded로 첨부 파일 전송(유료)을 활성화하고 쓰기 권한이 있는 Holded API 키를 입력합니다.
- 증거 탭에서 고객이 자신을 인증하는 방법을 선택하고 저장합니다.
문서를 첨부하려면 문서를 열고 Holded에 첨부를 클릭하여 대상을 확인합니다. PaperOffice는 문서 번호로 대상을 찾으며, 여러 일치 항목이나 일치 항목이 없으면 전송되지 않습니다. 파일 크기는 최대 10MB까지 가능하며, 이미 첨부된 문서는 다시 전송되지 않습니다. 조회, 보관 및 첨부 기능은 유료입니다.
JTL-Wawi
PaperOffice는 공식 JTL API를 통해 JTL-Wawi에서 주문, 추적 번호가 포함된 배송 영수증 및 가격 정보가 포함된 품목을 읽습니다. 연결은 읽기 전용이며 JTL-Wawi에는 변경 사항이 없습니다.
- Knowledge Base AI → 운영 소스로 이동하여 출처 추가를 클릭하고 연결로 JTL-Wawi를 선택합니다.
- 연결 탭에서 JTL Cloud 또는 온프레미스 JTL-Wawi를 선택합니다. JTL Cloud의 경우 테넌트 ID를 입력하고, 온프레미스의 경우 HTTPS 주소와 앱 등록에서 API 키를 입력하세요.
- 미리 보기를 위해 실제 주문 번호를 입력하고 증거 탭에서 증명을 선택하세요.
- 미리보기 탭에서 저장 없이 미리 보기를 클릭한 후, 지금 동기화로 저장하고 첫 번째 동기화를 시작하세요.
온프레미스 환경에서 JTL-Wawi는 표준 포트 443의 공개 HTTPS 주소가 필요하며, 내부 주소와 HTTP는 차단됩니다. 계정에 JTL Cloud가 이미 활성화되어 있는지 지원팀에 문의하세요. 연속 세 번의 가져오기 실패 후 소스가 자동으로 일시 중지됩니다. 가져오기는 유료입니다.
GLS, DB Schenker 및 DHL을 통한 배송 추적
고객이 "내 소포는 어디에 있나요?"라고 물을 때, PaperOffice는 GLS, DB Schenker 또는 DHL에서 배송 상태를 가져옵니다. 운송사에 대한 자체 자격 증명이 필요합니다.
- Knowledge Base AI → 운영 소스를 열고 소스 추가를 클릭한 후 유형 GLS (2단계), Schenker (2단계) 또는 DHL을 선택하십시오.
- 연결 탭에서 자격 증명을 입력하십시오: GLS의 경우 ShipIT 주소, 사용자 이름 및 비밀번호, DB Schenker의 경우 접근 키, DHL의 경우 API 키입니다.
- 미리 보기를 위해 실제 추적 번호를 입력하고, 증명을 선택하며, 미리 보기를 확인한 후 저장하세요.
- 동기화 탭에서 지금 동기화를 클릭하세요.
나중의 동기화는 기존 추적 번호를 자동으로 읽습니다. SMS 또는 이메일을 통한 고객 상태 메시지는 실제 상태 변경 시에만, 그리고 메시지 탭에서 활성화한 경우에만 전송됩니다. 기본적으로 꺼져 있습니다. SMS는 유료입니다.
데이터 서비스: 부가세 ID, 환율, 지오코딩 및 지도
PaperOffice는 네 가지 데이터 서비스를 제공합니다: EU VIES 시스템을 통한 부가세 ID 확인, 변환 기능이 있는 환율, 지오코딩 및 지도입니다. 모든 플랜에서 사용할 수 있는 Data AI Playground에서 앱을 통해 이를 테스트하고, REST API 또는 MCP 커넥터를 통해 자체 시스템에서 사용하세요. API 요청은 유료입니다.
- 부가세 ID: 확인은 VIES를 통해 수행되며, API를 통해서는 최대 100개의 번호를 배치로 처리할 수 있습니다. 27개 EU 국가의 부가세율도 제공됩니다.
- AI-DMS Ultra는 각 문서에 대해 공급업체의 부가세 ID를 VIES를 통해 자동으로 확인합니다. 이는 유료입니다.
- 지오코딩: 주소에서 좌표로, 좌표에서 주소로, 주소 제안 기능 제공. API를 통해서는 최대 1,000개의 주소를 배치로 처리할 수 있습니다.
- 지도: Analytics AI → 발신자 지도에서 AI-DMS가 문서를 처리한 후 문서의 발신자를 지도에서 확인할 수 있습니다. Analytics AI는 Corporate 플랜부터 제공됩니다.
자주 묻는 질문
- 준비된 n8n 노드가 있나요? HTTP 요청, 웹훅 또는 n8n의 MCP 클라이언트를 통해 연결할 수 있습니다.
- PaperOffice가 Holded 또는 JTL-Wawi의 데이터를 변경하나요? JTL-Wawi는 읽기 전용입니다. Holded에서는 첨부 파일만 전송되며, 별도의 키로 이를 활성화한 경우에만 가능합니다.
- 고객이 증명 없이 주문 상태를 볼 수 있나요? 아닙니다. 에이전트는 증명 후에만 고객 데이터를 공유합니다.
- 어떤 운송사가 지원되나요? 현재 GLS, DB Schenker 및 DHL을 위한 준비된 연결이 있습니다.
- 여러 부가세 ID를 한 번에 확인할 수 있나요? 네, API를 통해 최대 100개의 번호를 배치로 확인할 수 있습니다.